HP 3000 Computer Systems 



...- •#*■ 

i-3: 



MPE V TABLES MAlllpU 
MPE V/E (VUF G.O8.60)' 

mpe v nmamms* 

A 



WSSt HEWLETT 
tUHJk PACKARD 



80 10 FOOTHILLS BLVD. ROSEVILLE.CA 95678 



( Part No. 32033-90147 Printed in U.S.A. 10/91 

V El 091 *.V' Y ' ; 



CAUTION 



The normal checks and limitations that apply to the 
standard MPE users are bypassed in Privileged Mode. It 
is possible for a Privileged Mode program to destroy file 
integrity including the MPE operating system software 
itself. Upon request Hewlett-Packard will investigate 
and attempt to resolve problems resulting from the use 
of Privileged Mode code. This service is available on a 
time and materials billing basis. However, 
Hewlett-Packard will not support, correct, or attend to 
any modifications of the MPE operating system 
software. 



NOTICE 

The information contained in this manual is proprietary and may not be disclosed to third 
parties. The terms and conditions of release of this information to the recipient are 
governed by the agreement executed at and between Hewlett-Packard and the recipient 
regarding the HP 3000 internal MPE V System Table Structures, including the MPE V 
Tables Manual for MPE V Operating System. 

Hewlett-Packard does not warrant the accuracy or completeness of the information con- 
tained in this manual. Hewlett-Packard may make revisions to the MPE operating system 
or CPU firmware that may affect the information and specifications contained herein. 
Hewlett-Packard shall have no obligation to provide the recipient with notification of 
revisions, corrections, or updates regarding the information contained herein. 

Hewlett-Packard shall not be responsible for any loss or damage to the recipient, its cus- 
tomers, or any third party caused by the recipient's use of the information provided 
herein. 
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PREFACE 



This edition of the MPE Release 23 Tables Manual describes the internal table organiza- 
tion of the MPE V operating system. It is intended for the technically sophisticated user 
with Privilege Mode capability. We strongly discourage modifying the contents of the 
MPE tables because you may destroy the operating system The following caution applies: 



CAUTION 



The normal checks and limitations that apply to the 
standard MPE users are bypassed in Privileged Mode. It 
is possible for a Privileged Mode program to destroy file 
integrity including the MPE operating system software 
itself. Upon request Hewlett-Packard will investigate 
and attempt to resolve problems resulting from the use 
of Privileged Mode code. This service is available on a 
time and materials billing basis. However, Hewlett- 
Packard will not support, correct, or attend to any 
modifications of the MPE operating system software. 
Hewlett-Packard reserves the right to change the struc- 
ture and the content of any system tables in future 
releases of MPE. 



The major highlights of this edition include: 

• Corrections/ Additions were made in bringing the information up to Release 23. 

We hope you will find this edition informative. Your comments and suggestions are welcome via the 
"Reader Comment Sheet" at the back of this manual. 
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1 - STT Violation in Segnent 11 

2 - Rbeent Segnent while executing on the ICS 

3 - Rbeent or Trace on Segnent »1 

4 - Stack Overflow on the ICS 

5 - CST Table length (word 0) found to be 

6 - Bootetrap Channel Progran Tineout 

7 - Bootstrap Checksun Error 

8 - Bootstrap Channel Progran Abort 

9 - PSEB Instruction while QI-18 • 

10 • Hodule Send Reeeage Tineout 

11 - Incorrect Hodule Responding 

12 - Channel not Syeten Controller 

13 - Code Segnent Violation while in Segnent i1 

14 - Non-reeponding Channel 

15 - Channel Responding (to IPOLL) 

16 - No CSRQ or IRQ on nsssage Interrupt 

17 - Channel cannot be nade Controlier-in-charge 

18 - Hodule Receive nessage Tineout 

19 - I/O Error, Parity or Tineout 

20 - I1CS Checksun Error 

21 - LUT Checkeun Error 

22 - Bad CPU Connand Code 



1516 * DRT 

1517 « DRT 1 

1520 » DRT 2 

1521 « DRT 3 

1522 * DRT Bank 

1523 * DRT Address Offset 
(6x/70 only) 1524 ■ Interrupt Hask For W80 
(6x/70 only) 1525 • Interrupt nask For MB1 
(6x/70 only) 1526 « Interrupt nask For IHB2 
(6x/70 only) 1527 • Interrupt Haek For IHB3 

1740 • Start Of SyeGlob Extension 



G. 23.00 
1- 14 



n 



Henory Layout 

Z200 words long; Pointer found at SyeDB ♦ Z377 



Z 0| 
1 
2 
3 
4 
5 
6 
7 

10 
11 



SURP QUEUE DELAY (*100nS) 



BANK / BRSE ADDRESS 
OF FIRST HEnORY 
REGION IN LINKED nEnORY 



GARBRGE COLLECTION ENABLE FLAG 



SURPQDELAY 

FIRST 
HEHORY 
REGION 

GARBCOLLENAB 



HOVE THRESHOLD (IN PAGES, FOR GARB COLL) HOVETHRESH 



nRIN HEHORY PAGE SIZE (IN UORDS) 



VDS PAGE SIZE 



TinE OF LAST HAXEROQfl CALL 



HOTWELAST- 

HAKEROOn 

LOTMELAST- 

nAXEROon 



HEHORY PRESSURE DURATION THRESHOLD 



NATIVE LANGUAGE TABLE (NLT) OST • 



RESERVED FOR NATIVE LANGUAGE SUPPORT 



BAUD RATE OF THE SYSTEH CONSOLE 



INITIAL LDEV OF SYSTEH CONSOLE 



12 
13 
14 
15 
16 
17 
20 



21 | UORD niCROCOOED PROCEDURES, 
| PERFORMANCE FEATURE SET BIT RAP 



PLABEL FOR REHOTE'HPE 



PLABEL FOR GETDS'NODENRHE 



UCS VERSION 



22 | UORD 1 niCROCOOED PROCEDURES, 
| PERFORMANCE FEATURE SET BIT HAP 
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23| UORD 2 niCROCOOED PROCEDURES, 
| PERFORMANCE FEATURE SET BIT HAP 

24| UORD 3 niCROCOOED PROCEDURES, 
| PERFORMANCE FEATURE SET BIT HAP 
I- 
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flenory Layout 



SvtGlob Extention (Cent.) 

For Uord 3 (Z24) the following applies: 

Bit 15 it tet if ERRORON'70 it present 
Bit 14 it ttt if ERROR EX IT' 70 it pretcnt 
Bit 13 it tct if EXCHRNGEDB'70 it prcttnt 
Bit 12 it ttt if TinER'70 is prttent 
Bit 11 is tet if TIOEREO'70 is present 
Bit 10 is set if nnSTflT'70 is present 



/|**\ 



30I 



SECURITY TABLE 



sr 
, 

60 I PLRBEL USERLOG (EXTERNAL) 
61| PLRBEL USERLOG (INTERNRL) 
621 PLRBEL RECLOG (EXTERNRL) 



I- 



631 PLRBEL RECLOG (INTERNRL) 
64| PLRBEL RESTART (EXTERNRL) 



I- 



651 PLRBEL RESTART (INTERNRL) 
661 PHBC LOU CORE BRNK N (USER) 



I- 
67| 



PHBC LOU CORE RDORESS (USER) 



701 



I — 



711 

I- 
721 



RESERVED FOR WAGE 
RESERVED FOR HEASIO 



LOADER CRCHE SEGflENT NUflBER 



I fllOCNT 
-l-l-l- 



731 PLRBEL 3270 
| 

74| VERSION 



751 



(EXTERNRL) 



UPDATE 



761 



FIX 
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flenory Layout 



SvsGlob Exte nsion (Cont.) 



77 1 



COUNT OF TAPE CONTROLLERS USING AEASIO 



1001 PORT DRTA SEGflENT NUflBER 

101 l RESERVED FOR SECOND PORT DATA SEGflENT 



I- 
1031 
104| 
1051 
1061 
107| 
1101 

I- 
1111 

I- 
112] 

117| 

I- 
1201 

I- 
1211 

I- 
1221 

I- 
1231 



Sv.n.'EA FPflflP OPTION FLAG 



GLOBAL ALLOU flASK 



nflSTAT ENABLE UORO 
RESERVED 



SYS PORT PROCESS PCS RELATIVE INDEX 
GLOBAL AFT DST NUflBER 



INITIRL/PROGEN COflfl. DSEG NUflBER (CH. 16) 



INITIAL SYSTEfl STARTUP OPTION 



I- 

124| PORT' IIAX'SER' COUNTER 

1261 CURRENTLY UNASSIGNED 
127| 

| 

1301 Address Allocation DST 

131) IPC Plabel 



I- 

132! Rulticast DST 
I 

1331 PD DST 

134| IP Update DST 
1351 Node Nant DST 



1361 



Address Reference DST 



137| IP Identification 
| 



SYSFPHAP 



SVSGLOB EXT. 
Z130 - Z144 
HAVE BEEN 
ALLOCATED TO 
NS TRANSPORT 
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flenory Layout 



fltnory Layout 



SvsGlob Extension (Cont.) 



SIM DST 



Flags uord 
Trigger DST 
Util. DST 
FastPatn Sfl4 
RESERVED FOR SPL 
PATH FLOU 
ANALYZER 



140 

141 

142 

143 

144 

145 

146 

147 1 

150 

151 

152 

153 

154 

1551 

156 PSEUOO TERWNAL UMKRGC 

157 



PC SUBSYSTEfl INFO 
KODIAK fl-CQDE PERFORflANCE 
flRESTRO'UORD 
nAESTRO DST-NUflBER 



« SYSGLOB Z155 IS UNUSED » 



VIRTUAL TERfllNAL LINKAGE 



160 

I 

1611 



DST « FOR NS/3000, X.2S PRODUCT STARTED 

PAD (Package Rssenbly/Disassenbly) 

flf-T PRCrJwT VERSION LEVEL (VD4 and later) 



1621 

I- 
163! 

I 

1641 nPE fRODUCT FIX LEVEL (VD4 and later) 



flPE PRODUCT UPDATE LEVEL (VD4 and later) 



I- 



1651 NS/X.25 DST N (VD6 and later) 
I 

1661 



PLABEL OF TRPE RGflT CATALOG PROCEDURE 



167| 



RESE^'ED FOR KM3UN VENDOR TABLE 



• fllOCNT « I1EASI0C0UNT (3 BITS) 
*** BIT ■ Enable HARDRES IMSTAT call 

flRESTRO'UORD DEFINITION 

(0:1) « 1 * START' UP' BIT 

(1:9) - (Not Used) 
(10:1) * 1 » Pending Spooler Request 
(11:1) * 1 ■ Queue Entry in XDS 



flRESTRO DST-NUflBER • 



200! 
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Contains the DST index for the XDS 
shared betueen Filter and GENflSG. 

NS/X.25 DSTN(uord Z165) - DST « for the APE V/E NS/X.25 

TRANSPORT link for INP's. 
STARTUP OPTION(uord XI 23) - Contains the last LORD/STRRT 
option as follous: 

« URRflSTART 

1 » COOLSTRRT 

2 « COLDLORD(or COLDSTRRT) 

3 * UPDATE 

4 « RELORD (RCCTS/NULL/SPREAD) 

5 * RELOAO (COflPACT) 

6 « RELOAD (RESTORE) 
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Rtttory Layout 



?Y?08 Uordt 



Systen tablet n»y be accessed by using the LST/SST instructions. Pointtrs 
have tht follouing fornat: 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|~|H~l--l--i--l--|--l--l--l"l--l--l"IHH 
| fiOORESS I BANK | 
, 1 | 

Rddrtss xt tht uhoit word uith "Bank" nasktd out to 00000 

Sytttns that have ftPE V/E nicrocodt (all 6X systens, 4X systens Mith ntu 
boards) can have a non-zero bank nunbtr. Systens running pre-RPE V/E 
nicrocode can only use bank 0, therefore the pointer uill look like: 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
M-M-M-l-l-M-l-M-l-M-l 
I RDDRESS | 

, 1 



ROORESS 


NflflE 


09*55 


BUSY 


08*56 


HERD 


03*57 


TRZL 


DB*60 
0B*72 


SIO COUNT 
POUER FRIL 


08*73 
08*74 
D8*400 


SYSUP 
CONSLOEV 
CPU NUHBER 



SvsGlcb Uord Definitions 
FUNCTION 

- SYSDB relative pointer to BUSY TRBIE for 
I/O resources 

- SYSDB relative pointer to table containing 
head pointers to I/O resource queues 

- SYSDB relative pointer to table containing 
head pointers to tail of I/O resource queues 

- Nunber of I/O Prograns currently executing 

- O-no pouer fail 

1 -systen disc recovery 
2-all other disc recovery 
3-all other device recovery 

- Systtn is up and operable 

- Systen console logical device nunber 

- Set uhen systen aborts 
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ntnopy Layout 

J08SYNCH - Job synchronization via jobsynch (sysglcb*121(8)) 

(13:1) - JOBSRERDY - set by DEVREC & HORGUE (via procedure STRRTDEVICE) 
indicating a reedy job. This prevents UCOP fron 
going to a uait state uhen a job is just nadc 
ready. 

(15:1) - OEVFREEO - set by OERLLOCRTE uhen device count goes to 0. 

NOTE: Both bits above used for synchronization of job-nadt-rtady or 
devictfreed uhen UCOP is running. 

(14:1) - J08SURITING- set by UCOP just before waiting if any job is 
uaiting for list device. Signals OERLLOCRTE to 
auake UCOP uhen a device is freed. 



Rllou nask Fornat 

The Rllou nask for ftPE V is expanded to six uords. The rt is a nask in each 
user's JIT and in the SYSGLOB arta. The Rllou nask contains enough bits for 
a one-to-one correspondence to every present OPERATOR type connand, or any 
future OPERATOR connand. Uhen a user is RLLOUed any OPERATOR connand or 
RSSOCIRTEd to a device (uhich uill use OPERATOR type connands) then the 
corresponding bit(s) in the nask in that user's JIT for that connand is set. 
If the RLLOU or RSSOCIRTE uas done on a global scale, then the bit(s) in the 
nask of the SYSGLOB »rt» is/are updated. 

The following EQURTEs define the nask bit for each operator connand. 

The first set of connands define the operator connands dealing uith devices. 

Uhen adding a neu connand to this set of EQURTEs, be sure to add a 
corresponding nove statenent in LOGIHRGC, even if the connand uill not be 
logged. 



^ 





Uord 


lit 


| 


RBQRTIO 











ACCEPT 





1 


1 


DOUN 





2 


2 


GIVE 





3 


3 


HERDOFF 





4 


4 


HERDON 





5 


5 


REFUSE 





6 


6 


REPLY 





7 


7 


STRRTSPOOL 





8 


8 


TRKE 





9 


9 


UP 





10 


10 


UPLINE 





11 


11 


DSCONTROL 





12 


12 
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fkmory Layout 



Renory Layout 





AUpulask (Cont t ) 


Uord 


m 


1 


UPPER Uf)IT->DEVICE COMANOS 




RBORTJOB 


13 


13 


RLLOU 


14 


14 


ALTSPOOLFILE 


15 


15 


RLTJOB 1 





16 


BRERKJ08 1 


1 


17 


DELETESPOQLFILE 1 


2 


18 


DISALLOU 1 


3 


19 


JOBFENCE 1 


4 


20 


LMIT 1 


5 


21 


STOPSPOOL 1 


6 


22 


SUSPENDSPOOL 1 


7 


23 


OUTFENCE 1 


8 


24 


RECRLL 1 


9 


25 


RESUnEJOB 1 


10 


26 


RESUHESPOOL 1 


11 


27 


STRERnS 1 


12 


28 


CONSOLE 1 


13 


29 


URRN 1 


14 


30 


UELCOflE 1 


15 


31 


nON 2 





32 


nOFF 2 


1 


33 


VROUNT 2 


2 


34 


U10UNT 2 


3 


35 


LDISnOUNT 2 


4 


36 


ItRJECONTROL 2 


5 


37 


JOBSECURITY 2 


6 


38 


DOUNLORD 2 


7 


39 


niOENRBLE 2 


8 


40 


niOOISRBLE 2 


9 


41 


LOG 2 


10 


42 


FOREIGN 2 


11 


43 


MFCONTROL 2 


12 


44 


SKOUCQn 2 


13 


«5 


OPENQ 2 


14 


46 


SHUTQ 2 


15 


47 


DISCRPS 3 





48 



timiW Stiltf?" locations 



SYSDB 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
17Z| — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — I 

or | STATE | DST • I 

STATE ■ if respective buffer enpty 

1 if respective buffer is current 

2 if respective buffer is full 



FLflGX 

SYSDB 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|-|~M"|-|-|"|~|~|~|~|"|"|— M--I 
1761 |SF|HF|BUF|SL|SD| 

SF > 1 if soft failure 

HF ■ 1 if hard failure 

BUF ■ if current log buffer it buffer 

• 1 if current log buffer is buffer 1 

SL > 1 to indicate a suitch in log buffers (fron to 1 or fron 1 to 0) 

SO » 1 to indicate shutdown in progress 
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Atnory Layout 





Proefts Stoo List General Layout 


fSDB 




300 


STOP BITS REPRESENTING UHICH 

PROCESSES TO STOP ON "SHUTOOUN" 




N PROCESS ENTRIES 




1ST PROCESS ENTRY 




2N0 PROCESS ENTRY 




: 


317 


LAST PROCESS ENTRY 



Entry Forwtt 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
— I — I — I — I — I — I — I — I — I — I — I — I — I — I — I — I 

PROCESS PIN tt I STOP BIT N 

PROCESS HAIT STATE 



Pensioned Entritt 



PROCESS 

dtvrtc 

ucop 

lo 9 



STOP BIT i 

2 


1 
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BankO 



LOU CORE AEAORY 



>DRT 



SYSTEft GLOBAL AREA 
FIRHURRE RRER 
SYSGLOB EXTENSION 
OST/CST/CSTK 



fltnory Layout 



(Only on 6x/70 if 
Privilege Aode Bounds 
Chocking is enabled.) 



ICS 



PABC 



ILT/OIT 



(Only for 6x/70 if 
Priviligt Aode Bounds 
' Chocking io enabled.) 



OLT 

RESOURCE TRBLES 



CST BLOCK 



>AEAORY AERSUREAENT INFO 



VOSH TABLE 



JOB PROCESS COUNT 



>PRI/SEC tlSR 
">PC8 



>SUAP TABLE (SLL) 
>SPECIAL REQUEST TRBLE 



f*l 



>J08 CUTOFF TABLE 
>TMER REQUEST LIST 



1 



>SYSTEf1 BUFFERS 
>LPOT 



>IOQ 
>SIR 
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fltnory Layout 



Initial flenorv Allocation 



This section is a description of the nethod uted by INITIAL to allocate 
nenory for APE tables and code segnents in APE V/E. All nenory allocated by 
INITIAL it permanently allocated. All non-core resident code and data is put 
on disc before exiting INITIAL. 

At the nost basic level INITIAL uill try to build nenory to look exactly as 
diaartnned belou. There are, however, several ways in uhich to deviate fron 
this • .ir.ture. Before goino into the sources of these deviations, it is 
necessary to point out uhi' jortions of nenory *rt used by INITIAL during 
the restart and, therefore, cannot be used by APE until INITIAL has finished. 

Before INITIAL begins to allocate any nenory space, it relocates its core 
resident code, its code segnent swapping *rt* and its stack to the highest 
configured nenory space. Additionally, it uses the last Z326 words of bank 
on series 4X nachines for its I/O buffer area and tenporary code segnent 
table. After INITIAL has built all of core resident APE (tables and code), 
it builds the disc resident APE tables. Since sone of the disc resident 
tables nay be too large to be built in INITIAL'S stack, these tables *rt 
built in unused nenory space. Therefore, in addition to the nenory space 
required for INITIAL'S code, INITIAL'S stack and cort resident APE, there 
nust be enough space left in uhich to build the largest of the disc resident 
tables. 

For Series 6X nachines uith the APE V/E fimuare, INITIAL uill build the 
tables uith ">" signs by then out of Bank if necessary. For all other 
tables, INITIAL uill essentially build nenory in the order shown belou. 
There nay be an unused fragnent of nenory between the ORTs and the systen 
global area uhich INITIAL uill fill uith the snaller tables. Neither the 
tables narked uith an asterisk nor the code segnents uill ever be put in this 
area. NOTE: INITIAL uill build all tables on 32-uord boundaries. 

If the systen being built by INITIAL is configured uith 128K words or 160K 
words of nenory then INITIAL'S stack uill be in bank 1 (the code also on a 
128K word nenory size). If INITIAL is occupying part of bank 1 and the space 
is needed for a core resident APE code segnent or to build a disc resident 
table then INITIAL uill print the error nessage "ERROR N350 OUT OF AEAORY". 

Except for the exceptions stated above, for every allocation of ntnory 
INITIAL uill first try to allocate any renaming space between the ORTs and 
SYSOB. It uill then try the next available space in bank 0, then the next 
available space in bank 1. If it uere necessary it could continue starching 
until all all banks utrt checked for available spact. 

Innediately before txiting INITIAL, INITIAL lays doun all tht ntnory region 
headers and trailers as shown belou. For any one bank of nenory there uill 
only be one block of core resident APE, regardless of its contents. Tht only 
block of core resident APE that does not have a reserved region global header 
is in bank 0. It does have the reserved region global trailer though. 
Before placing any codt outsidt bank tht first 24 words of every bank 
(except bank 0) is reserved for the region global header. 
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ntnory Layout 



Bank (Cont.) 



I 

| >hON TABLE 



I CO?E RESIDENT CST'S I 

i IN ORDER 

I 

I 

I RESERVED REGION GLOBAL 
I TRAILER 

I 

I AVAILA6LE REGION GLOBAL 

I HERDER 

I 



AVAILABLE AEAORY 



I 



I — 
I 

I 
I- 



AVAILABLE REGION GLOBAL 
TRAILER 



NOTE: The > ntant thtst tablts can novo out of Bank if necessary. 
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dtrary Layout 



Bank 1 



RESERVED REGION GLOBAL 
HERDER 



CORE RESIOEMT CST'S RND 
TABLES nflRKED UITH ">" 
THAT DIDN'T FIT IN 
BANK 






RESERVED REGION GLOBAL 
TRAILER 
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Rtnory flanagenent Tables 



CHAPTER 2 nFnORV rMNAGEnENT TABLES 
Stowent Table Structure 



The current location and state of each data tcgnent and loaded code eegnent 
is naxntained in the Segnent Table. Thit table it partitioned into three 
separate tables as shoun belou. The partitions *rt based on the segnent 
classes: a segnent is a data segnent, a segnent is a syster «' segment, or a 
segnent is part of a progran. The structure and fomat of «ach partition is 
described in the foliouing. 



Overall ST Structure 



(Z2),(Z1002)*SYSBASE • 



(Z0),(Z1001)*SYS8ASE 



I DST | 

I 

I- 

I 



I 

-I 

I 

I CST | 



CSTBLK |- 
| 1 | 

(Z1051) ->| | | 

I 1 I 

I I 1 

| 1 



I 
I 
I 
| 1 

I I- 
| 1 

I I 
I I 
| j 



I 
-I 

— > | CSTX I 
I FIRST | 
I LOQDEDI 
I PROCRRH | 

>| 1<- 

I NEXT | 
I LOADED | 
IPR0&RP1I 



(Z3), CURRENT PROGRAH. POINTER 
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Renory flanagenent Tablet 

Pointers and DST R's of Segnent Table Conoonente 

i. DST 

Z 2 absolute address of entry of the DST. 
Z1002 sysbase relative index of entry of DST. 
DST nunber 2 is the OST Table DST I. 

ii. CST 

Z absolute address of entry of Systtn SL. 
Z1001 sysbase relative index of entry of Systen SL. 
Z1032 displacenent fron DST base of entry of Systen SL (i.e., 
ecST(last) - IDST(O) « DFS ). 
| DST nunber 1 is the CST Table DST t. 

iii. CSTX 

Z 1 absolute address of entry of current progran. 
Z1033 displacenent fron DST base to first CSTX entry SL 
DST nunber 4 is the CSTX Table OST t. 

iv. CSTBLK 

Z10S1 sysbase relative index of CST Block Table. 
| DST nunber 35 (Z43) is CSTBLK' • DST «. 



Renory Hanagenent Tables 



Standard Object Identifier Fomat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

..I--M--IHH--I--I--M--M--I--I--M 

TYPE | CST BLOCK - RELATIVE INDEX 

OBJECT NURBER I 
1 



OBJIDENTIFIER(0).(0:4) « TYPE 

■ Object is a Data segnent 

* 1 Object is an SL segnent 

■ 2 Object is a Progran segnent 

• 3 Object ie a Cache Donain 

0BJIDENTIFIER(O).(4:12) « CST BLOCK Table index to list of CST segnents 
0BJIDENTIFIER(1).(O:16) * Nunber field: 

DST, CST, CSTX, or CDT nunber 



DST Entry Fornatt 



DST/CST Entry Fomat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

M-I~M-M"M-M-I~M-I-M 
IOR0 0| « CONFIGURED ENTRIES I 

UORO 1 | ENTRY LENGTH (4) I 

UORD 21 « AVAILABLE ENTRIES I 

| 1 

UORD 31 TABLE RELATIVE INOEX TO FIRST FREE ENTRY | 
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Rtnory nanagencnt Tablet 
DST General Entry Format 

Cate (i) OST Entry for 4 Preient Data Segnent 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 IS 
1 — I — 1 — I — I — I — I — I — I — I — I — ■ — ■ — ■ — ■ — ■ — 

UORO 0|A |0 |R I SIZE/4 

I 



UORD 1 |0 |R II IS in |F |S IC |U | 

ic 10 in IT |0 |U |Y 10 ID 1 

|V |C II |K 10 II IS IR I I 

I I I I I IP I IE I I 



VHRLLOC 



I- 

UORD 2| BANK 



I- 
UORD 31 BASE 



I- 



Cate (ii) OST Entry for an Rbaent Data Segnent 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

M ..|.-|~|~|~|-|~|~|~|"|--IH"M" 
UORD 0|A |0 |R | SIZE/4 

UORO 110 |R |I IS in |F IS |C IU I 

IC 10 in IT |0 |U |Y 10 ID | 

IV |C II IK ID II IS IR I I 

! I I I I IP I IE I I 

LDEV « I HODA 
1 

IDDA 



FIRHINFO 
FLAGS 

HHBRNK 



VnALUJC 



I- 
121 
I- 



UORO 31 
I- 



FIRniNFO 
FLAGS 



HODA 
LOOA 



Renory nanagencnt Tablet 



C$T Entry Fornatt 



CST General Entry Fomat 



Cate (i) CST Entry for a Pretent SI Segnent or CSTX Segnent 



1 i 3 4 5 6 7 8 9 10 11 12 13 14 15 

|..|..|~|-.|~|~|~|"|"l--l"l"l~l--|~l"l 

UORO 01 A |n |R |T I SIZE/4 IFIRMNFO 

I 1 

UORO 11 IR II I I I IS |C I I 

I 10 in I I I |V 10 I FLAGS 

I IC II I I I IS IR I 
I I I I I I I IE I 



IR II 1 1 

10 m 1 1 
IC 11 1 1 
1 1 1 1 


i IS |C | 

1 IV 10 | 

1 IS IR 1 

1 1 IE 1 

. 


BANK 



I 

UORO 21 
I 
UORO 3| BASE 



IHHBANK 
I 



1 



innsASE 
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CASE (ii) CST Entry For An Abtent Segnent SI or CSTX Segnent 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

|-|-.|-|-|-|-|-|-l"l--l"l"|-|-l-|-l 

UORO 0|fl in |R |T | SIZE/4 | FIRHINFO 

| 1 

UORO 11 IR II I I I IS IC I I 

I 10 |R I I I |V 10 I IFLAGS 

I IC IX I I I IS |R I I 

I I I I I I I IE I I 

UORO 21 LDEV « I KOOA IKOOA 

UORO 3| LODR ILODA 



Cate (iii) OST/CST Free Entry 



2100000 



— I 

I 



-I 

TABLE RELATIVE OFFSET TO NEXT FREE ENTRY | 

-I 

I 
-I 

I 
-I 
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Renory nanagencnt Tablet 



Refer to the Logical Segnent Table Format in Chapter 11 for nore 
information on XCST. 



CST Entry Field Detcriotiont 

A ■ 1 « tegnent abtent 
n • 1 * tegnent privileged 
R « 1 ■ tegnent hat been referenced 
T • 1 « tegnent it beino traced 
DCV ■ 1 • ditc copy it valid 
STK ■ 1 ■ tegnent it a ttack 

ROD « 1 ■ a tegnent change in size or location it requetted 
FUIP ■ 1 « a forced urite of thia tegnent it in progrett 
VnPAGECNT « II of virtual nenory paget allocated to thia tegnent 
ROC * 1 * tegnent it recoverable overlay candidate 
ini * 1 * tegnent it in notion in 
SYS « 1 * tegnent it a tytten eegntnt 
CORE * 1 * tegnent it core resident 
19 • 1 « urite disabled 



CSTBLK formed 



nenory nanagencnt Tablet 



CST EXTENSION and the CSTXHAP 



Since progrant can be dynanically loaded and unloaded, the eegnent table nutt 
be kept packed or f ragnentation would occur. Thut, the block of ST entriee 
for a progran segnent begint at an ST entry nunber that chtnget if a progran 
uhich uas loaded before it gett unloaded. To nanage thit dynanic ttructure, 
an auxiliary ttructure, the CSTXHAP it used. The CSTXnAP ie a contiguout 
block of entries inside the CST EXTENSION. It containt a header entry 
describing the block of entriet and a group of CST entriet detcribing each of 
the progran code segncntt. The ttart of the CSTXHAP it pointed to by an 
entry (CSTXEIX) fron the CST BLOCK (CSTBLK) table. 



Entry Fomat - CSTXHAP 



1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 
I — I — I — I — I — I — I — I — 1 — I — I — I — I — I — I — I — I 

CSTBLK 01 NUnBER OF ENTRIES IN CSTBLK TABLE 

|_* 

1 1 ENTRY NUR8ER 1 
, . 

2 | ENTRY NUHBER 2 



l~ 
31 



ENTRY NUHBER 3 



n| 
I- 



ENTRY NUHBER n 



The table entriee in initialized to -1 to denote an unaatigned entry. Uhen 
an entry ie attigned, itt contentt it replaced uith a DST relative addrett 
uhich points to the header entry of the code tegnent litt (tee the CST 
EXTENSION table format for nore information) . 
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HEADER 
1 
21 



CODE SEG 1*0 1 A 



21 



21 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
— I — I — I — I — I — I — I — I — I — I — I — I — I — I — I — 

«• OF CODE SEGHENT ENTRIES OF THIS BLOCK 



XI 25252 

NUHBER OF USERS SHARING THIS 8 LOCK 




•I--I--I--I- 
IP IR IT I 



SIZE/4 (UORDS) 



ID |R II IS in |F IS IC |U I 

1 C 10 |H |T |0 |U |Y |0 |0 I 

V |C II |K |0 II IS |R I I 

I I I I IP I IE I I 



VRALLQC 



BANK/BASE ADDRESS OF 

CODE SEGHENT IN REHORV 
OR 

LDEV* H00A/L0DA ADDRESS 
OF COOE SEGHENT ON DISC 



-l-l-l-l- 
CODE SEG 2*0 A |P |R |T | SIZE/4 (UORDS) 



|R II IS |H |F |S |C |U I 

C 10 |n |T |0 IU |Y |0 |0 I 

V |C II |K |D II IS |R I I 

I I I I IP I IE I I 



VMLLOC 



BANK/BASE ADDRESS Of 

CODE SEGHENT IN HEHORY 
OR 

L5Ev* "ODA/LODA ADDRESS 
OF CODE SEGHENT ON DISC 
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Rtnory Hanagtnant Tabltt 
Entry Fornat - CSTXHAP (Cont.) 



I- 



1 - 1 - 1 - 1 - 1 1 

COOE SEC n«0|R |P |R IT I SIZE/4 (UOROS) I 


IMA II is in |F IS |C |U | | 

i ic io in it io |u iy io id I vnaiioc 1 

IV IC II IK |0 II IS |R I I | 
1 1 1 1 1 IP 1 IE 1 1 1 


2| BANK/BASE RDORESS OF | 
| COOE SEGHENT IN nEMRY | 
1 OR | 

3| LDEVN KOOR/LODA RDORESS I 
| OF COOE SEGHENT ON DISC I 



Tht valut of CSTXEIX it tttabliahtd uhtn i CST txttntion block it allocattd. 
This mdtx into the array CSTBLK it naintaintd in tht PCB of tach procttt 
tharwg tht block. 
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Rtnory ntnagtntflt Tabltt 

Fixtd DST Entry Rttitnntntt (Cont.) 



OCTAL 
25 
26 
27 
30 
31 
32 

33 
34 

351 
36 
37 
40 
41 
42 
43 



44 
45 

46 
47 

50 
51 



DIRECTORY SPACE 

RIN TABLE 

*SUAPTA8LE (SLL) 

JOB PROCESS COUNT 

JOB RASTER TABLE 

TAPE LABEL 
TABLE 



LOG TABLE 



REPLY INFORHATION 
TABLE 



VOLURE TABLE 
BREAKPOINT TABLE 



LOG 6UFFER1 



LOG BUFFER2 



LOG ID TRBLE 



ASSOCIATE TABLE 
CST BLOCK 



•JOS CUTOFF TABLE 
SYSTEn JIT 
•SPECIAL REQ TRBLE 



VIRTUAL DISC SPRCE 
nRNRGERENT TRBLE 



DECIRAL 

21 

22 

23 

24 

25 

26 

27 
28 

29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 



DEVICE CLASS TABLE |40 



TABLE NARE 

RIN 

SUAPTAB 
JPCNT 
jnAT 

VOD 
L06TR8 

RIT 
VTAB 
STOP 



UDTA8 

CSTBLK 
JCUT 
SJIT 
SRT 

VDSHTAB 
DEVCLASS 



RESERVED KERNEL 



-I 



* Can bt novtd ovt of BANK if ntctttary. 
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ntnory nanagtntnt Tabltt 

Fj^rf DST Entry Attitnntntt 

OCTAL DECWAL TABLE NARE 

| 1 

Ol IO 

1 !" CST II CST 

j 1 

2| DST 12 OST 

I I 

3| *PCB 13 PCB 

| I 

4| CSTX 14 CSTX 

I I 

5| SYSTEH GLOBAL AREA 15 SYS 

| 1 

61 CORE 16 CORE 

7!" ---———— ~~ - KS 

101 'SYSTEn BUFFERS 1 8 SBUF 
I 1 

11| UCOP REQUEST QUEUE 1 9 UCRQ 
, 1 

121 PROCESS-PROCESS I 10 
| COnnUXICATION table I ppcoh 

I 1 

131 'I/O QUEUE 111 IOQ 

| 1 

14| TERniNAL BUFFERS |12 T8UF 

| 1 

151 'LOGICAL-PHYSICAL |13 

I DEVICE TABLE I LPDT 

1 .„«.»......••——••—•-•-•«••««> j 

161 LOGICAL DEVICE 1 14 

I TRBLE I LOT 

| 1 

17| DRIVER LINKAGE TABLE I 15 DLT 

I J 

201 I/O RESOURCE TABLES 1 16 BUSY, HERO. TRIL 

| 1 

211 'SECONDARY HSG TABLE 117 SECnSGTAB 

| 1 

22 1 'LOADER SEGflENT TRBLE 1 18 LST 

| 1 

23 1 TIBER REQUEST LIST |19 TRL 

, 1 

24 1 DIRECTORY 1 20 DOS 

, 1 

* Can bt novtd out of 8RNX if ntctttary. 
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ntnory nanagtntnt Tabltt 



Fixtd DST Entry Attiarmtntt (Cont.) 



OCTAL 



I 

52 


"""~ilt"~ 


53 
54 
55 
56 

57 


'SIR TRBLE 
FHAVT 

INPUT DEVICE DIRECT 
OUTPUT DEVICE DIRECT 
UELCOnE HESSAGE il 


60 


UELCOnE HESSAGE A2 


61 
62 

63 


CS DATA SEGnENT 

PROCESS-JOB 

CROSS REFERENCE 

SYSTEn JDT 


64 


COnnAND LOGON DST 


65 

66 

67 


nOUNTED VOL. SET TABLE 
PRI. VOL. USER TRBLE 
RESERVED KERNEL 


70 
71 


DISC REQUEST TAELE 
flSG HARBOR TABLE 


72 


'PRIHRRY HESSAGE TABLE 


73 


•nESSjREnENT INFO TPBLE 


74 


FIRST F«?EE DST 



DECIITAL 


TABLE NAHE 


42 


ILT 


43 


SIR 


44 


FRRVT 


45 


100 


46 


ODD 


47 


L0G0NDSTN1 


48 


L0G0N0STN2 


49 


CSTAS 


50 


PJXREF 


51 


SYSJDT 


52 


CILOGOST 


53 


RVTAB 


54 


PVUSER 


55 

56 




DISCREQTR8 


57 
58 


nSGHRRBTAB 


PRinnSGTAB 


59 


nEASINFOTAB 


60 





* Can bt novtd out of BANK if ntctttary. 



M%^ 
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Henory Ranagenent Tablet 



The SUAPTA8 it a core resident nenory nanagenent table uted to Keep track of 
the locality littt of the competing procettet. Tht PCB tntry for a procett 
hat a SUBPTRB relative pointer to the header entry of the procett. 

SURPTRB DSTN = 23 (227) 

X1004 Sytten table pointer to SURPTRB entry 0. 

NOTE: The nunber of entriet configured uill be 3 
greater than the nunber configured via 
SYSDUHP. (Entry eontunet 3 entriet). 



SUflPTHB Entry Fornat 



OCTAL 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 DECMRL 
i — I — I — I — I — I — I — I — I — I — I — I — I — I — I — I- 

0| « ENTRIES CONFIGURED 



1 | ENTRY SIZE (6) 
| 

2 | « RVRILRBLE ENTRIES 

3 1 TABLE RELATIVE INDEX OF FIRST FREE ENTRY 

4 | TABLE RELATIVE INDEX OF LAST FREE ENTRY 
, 

5 1 HIGH UflTER HARK 

6 1 « PRIHRRY ENTRIES (0) 

7 | HERD OF IBPEDED QUEUE (PCB RELATIVE) 

10 | TAIL OF inPEDED QUEUE (PCB RELATIVE) 
11 



i CURRENTLY WPEOEO PROCESSES 
HRX « OF IRPEDED PROCESSES 



CUNJLATIVE « OF MPEDED PROCESSES 




M 
2 
3 
4 
5 
6 
|7 
18 
9 

no 
-i 

in 
-i 

112 

I 
I 
I 

117 



Henory Hanagenent Tablet 



SURPTRB Unattiontd Entry Fornat 

OlfflL 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 OECMRL 
|~|--|--|-IH~I~M~I~M~I~I--I-I~I 
01 Z100000 o 

I 1 

1| TRBLE RELATIVE INDEX OF NEXT FREE ENTRY |1 
I— 1 

2 1 TABLE RELATIVE INDEX OF PREV FREE ENTRY |2 
| .. . . 1 

31 IS 

I 1 

4| r. |4 

si o ~ ~~™ZIZZ]Ii 5 



Rn attigned entry in the SURPTRB it a procett' SLL header or a nenber of a 
procett' SLL. Thete fonatt are nou dttcribed. 



Uord 0: In an unuted entry only hat 2100000 if thit entry uat 
previoutly for a OST or CST, othervite it it 0. 

Uord 2: The PREVIOUS pointer* are not valid. HPE doet not namtain 
(or ute) then. Only NEXT pointert »rt valid. 

Uordt 3-5: Rre not zeroed out uhtn a uted entry btconet free, but 
uill ttill contain the old data. They are only zero'd 
uhen the table it firtt initialized. 
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henory nanagenent Tablet 



Saenent Locality Littt (SLL) 

Tht tytten naintaint for each procett a tegnent locality litt (SLL) of the 
etgncntt belonging to that procttt* current uorking set. The procett' SLL 
contittt of a header and a litt of entriet. The header and litt entriet trt 
taken fron the SURPTRB. 

R procett' SLL it located via the procett' PCB entry. PCB01 containt the SLL 
relative index of the procett' SLL header. 



SURPTRB 



henory Hanagenent Tablet 



Seenent Locality Litt (SLL) Header Fornat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
— I — I — I — I — I — I — I — I — i — I — I — I — I — I — I — I 

IS |H II IP IS IS I I I 

|U |R IN |R IT |U | | 

|R |S IT |R |R |I | | IOCNT 

IE |n |L IT |T |P | | 

IQ IE 10 II |0 | I I 

I in |C IN |V | | | 



TKRERO TO FIRST SLL ENTRY 



PCB01-J 
/- 



SLLKERDER 



FIRST SLL ENTRY 



>| NEXT SLL ENTRY 

-I 
, 



I I 






31 

I 



SLL REL ADDRESS OF OBJECT TO B€ 
BROUGHT IN 



I OF SEGflENT LOCALITY LIST ENTRIES 
OF PROCESS 



SCHEDTOIOnSG 

FIRSTINX 

nEnREQINX 
SEGCQUHT 
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SLL(SLLHER0INX«O) 

.(1:1) SUREQ, Suap Required Flag 
.(2:1) HRSnEn, Hat Henory Flag 
.(3:1) INTLOC, Initialize locality litt to nininun 
.(4:1) PflRTIN, Procett partially mapped in 
.(5:1) STRTOV, Start tuap over flag 
.(6:1) SUIP, Suap In Progrett Flag 
.(8:8) IOCNT, Nunber of READ I/O conpletiont until 
SUAPIN it conpleted and the procett 
it able to be auakened 
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ntnory nanagtntnt Tabltt 

Stontnt Locality list (SLL) Entry fornat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
.|H~|--M--M~I"I"M"IH"M 
PCB RELATIVE INDEX OF THE NEXT 
KAITING PIN 



SLL REL RDDRESS TO THE NEXT ENTRY 
IN THE LIST 



2| 

I 



SLL REL ROOR TO THE PREVIOUS ENTRY 
IN THE LIST 



I" 
31 
I- 
I 4| 
I" 

in 

IR 
SIP 
IS 
IE 
It 
I- 



08JECT 
IDENTIFIER 



IS |0 1MB IF IS IT IF |L |0 I 

IT II 10 IL |R |L 10 IZ |K |E I 

|R |S |C |K 10 |L IS IR |R IC I PREFETCH 

C IC IK |R IZ II IS IE IE |C I COUNT 

IK |I IE IE IE in | IQ |Q IN | 

I 10 ID 10 IN II | I I IT | 



NEXTINPPIN 

NEXTINX 

PREVINX 

SLL'OBJDESC 
SLL'OBJNUn 

SLL' FLAGS 



SLL(SLLINX*0) NEXTWPPIN, ntxt nake prettnt dtferred qutut 
PCB Index 

SLL(SLUNX*1) NEXTINX, ntxt SLL tntry 

SLL(SLUNX42) PREVINX, previous SLL tntry 

SLL(SLLINXO) SLL'OBJDESC, lit word of objtct idtntifitr* 

SLL(SLUNX«4) SLL'OBJNUn, 2nd uord of objtct idtntifitr* 



SLL(SLLINX*5) 



.(0:1) HRPSEG, Proctts* CST napping stgnent (LSTT) 

.(1:1) STK, Process' stack tntry 

.(2:1) DISCIOSEG, Disc I/O pending on this segnent 

.(3:1) LOCKED, Stgntnt locktd in ntnory 

.(4:1) 8LKLX. Rtquttt for blocktd lock 

.(5:1) FROZE, Stgntnt frown in ntnory 

.(6:1) SLUM, Procttt qututd for this ttgntnt 

.(7:1) TOSS, Tom this tntry 

.(8:1) FRZREO. Rtquttt ttgntnt to bt froztn 

.(9:1) LKREO, Rtquttt to iock ttgntnt in ntnory 

.(10:1) DECCNTFLAG, Dtcrtntnt N I/O conplttion btfort 

auakt flag 

.(11:5) PREFETCHCOUNT, Nunbtr of prefetch segnent 
rtquttt counttr 
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Htnory nanagtntnt Tabltt 



SRT Entry Fornat 



01 « ENTRIES CONFIGURED 

1 | ENTRY SIZE (6) 

I- 
21 

3 



« AVAILABLE ENTRIES 



101 



11 



TABLE REL. INDEX OF FIRST 
FREE ENTRY 



TABLE REL. INDEX OF LAST 
FREE ENTRY 



HIGH UATER HARK 



« PRinARY ENTRIES 



HERD OF inPEDED QUEUE 
(PCB REL.) 



TAIL OF IHPEDEO QUEUE 
(PCBREl.) 



N CURRENTLY IMPEDED PROCESSES 



121 k nAxmun mpeded processes 

131 CUnULATIVE * OF MPEDED 

| PROCESSES 

14|~""" * 

I 

I 

I 

I 
2U 
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Ntnory nanagtntnt Tabltt 

NOTE: Tht Suap Tabit will bt configurtd with at ltatt tuict the 
nunbtr of configurtd PCBt. 
* Stt Standard Objtct Idtntifitr Fornat for nort information. 

SPftCA'l Rtqutft T « b l* 

Ustd for passing data segnent size change info and for kttping a lift of 
devices waiting for a stgntnt to arnvt in nenory. 

Z1042 - SRT relative index to tntry II 

Z1043 - SRT rt lativt indtx to the head of tht qutut 

NOTE: The nunbtr of tntnes configured uill bt 3 grtattr 
than tht nunber configured via SYSDUnP. (Entry NO 
consunet 3 tntnet). 



,/*«^\ 



G. 23.00 
2- 17 



."*%. 



Htnory nanagenent Tabltt 
SRT Entry Fornat tCont.) 
Tht following tntry fornat it for data ttgntnt tilt/location nodifieationt: 



NEXT ENTRY FOR DATA SEGnENTS 



OBJECT 
IDENTIFIER 



NEU DATA SEGNENT SIZE 



READ DISPLACEIIENT 



HOVE COUNT 



Tht following it tht fornat for dtvictt waiting on a ttgntnt: (The region 
headtr for tht ttgntnt containt an SRT rtlativt indtx to thit tntry. If nort 
that 5 dtvictt art waitins on thit ttgntnt, another entry will be linked to 
thit tntry.) 



NEXT ENTRY OF QUEUED DEVS 
ON SEG 



IOQINX 



IOSINX 



IOQINX 



IOQINX 



IOQINX 



NOTE: Tht nunbtr of prinary configurtd tntritt will bt tqual to tht total 
nunbtr of LDEVt configurtd. Tht nunbtr of ttcondery tntritt will bt 
configurtd to bt at ltatt tht tant at tht nunbtr of PCBt configured. 
Data ttgntnt changt tntritt art ttcondary type, whilt dtvictt qututd 
tntritt uill bt prinary tntritt. 
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fttnory Hanagenent Tablee 

The following it tht fornat for a rtquttt to have tht data tegnent noved: 



I- 



THRERD TO NEXT ENTRY 



1 



31 



NEU SIZE 



4| STARTING SOURCE ROORESS 

I- 
51 



HOVE LENGTH 



Ham nenorv Region Headert and Trailert 

Hain nenory it partitioned into regiont. Each rtgion it in ont of four 
ttattt: available, reaerved, attigned, or cached. 

Rn available region it available for contunption by the free tpace allocation 
nechanitn. Rn available region contitts of neighboring tubregiont, each of 
uhich it either a hole or an overlay candidate. Rn available region it 
linked into the available region litt. 

R reserved region it a nain nenory region uhich it in the trantition ttate 
f ron available to attigned. R reaerved region hat been cleaned, and there it 
a pending ditc read of a tegnent into the region. 

Rttigncd regiont art occupied by preeent tegnentt. Available and reaerved 
regiont contitt of one or nore adjacent tubregiont. Region headera and 
trailert are partitioned into global and local conponentt. The global region 
header/trailer it only valid for the firtt/latt tubregion in regiont 
contitting of nore than one tubregion. 

The region headert and trailert of available, reaerved, and aatigned regiont 
contain the atate and control information pertaining to the current or 
planned contentt of the region. 

Cache donaint are another fom of attigned regiont and »rt deaignated at tuch 
in the tubregion header. If the cache donain ia "napped" (I/O pending 
againat it) then the object identifier uill have a non-zero value in the 
aecond uord of the tegnent identifier field. If the tecond uord of the 
tegnent identifier field it zero, then thit region it a cache donain that it 
unnapped. (Refer to Chapter 23 for further infornation regarding Ditc 
Caching. ) 
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nenory Hanagenent Tablet 



Global Region Trailer 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
IRB-Z34I HOT USED 
IRB-Z33I 



TRAILER SUBREGIOH SIZE (PAGES) 



I- 



PTSS 
PTRAS 



PTRS 



IR8-Z32I TRAILER REGION STATE 

I |A |R |A |C I 

I IS IE IV |L I 

I IS IS I IN | 

IRB-Z31I TRAILER REGION SIZE (PAGES) 
, 

| Trailer length « 4 



Global Region Header (Ava ilable Regiont) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|--|-|~|--M«M-I"I-M-M--M-I 
•R8-Z30I REGION ASSIGNMENT STATE IRAS 

|A |R IA |C IS IL IF II |L I IJ I 

IS IE IV |L IC |K |Z |0 IS I I 

IS IS | IN | |P IN |F |T | |P 

!!!!'! S i !ii r ! I 

, ---:-:::: J r$ 



IRB-Z27I REGION SIZE IN PRGES 
, 

IRB-Z26I 



I- 
IRB-Z25I 



|RB-Z24| PREVIOUS LINK (ROORESS OF PL FIELD 



I 

I- 
IRB-Z22I 



IPL 



OF PREVIOUS AVAILABLE REGION) 
NEXT LINK (AODRESS OF NL FIELD) 
IN NEXT AVAILABLE REGION) 



I- 
I 

I- 

IRB-Z20I 
I- 



| Header length * 24 (Z30) 



INL 
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nenory Hanagenent Tablet 



Subregion Header (Available Regiont) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|.. M -|--|--|--|~M-M~M~I"I"I~I 
|RB-Z17| SUBREGION ASSIGNMENT STATE ISAS 

|C |R |R |R |R II 
|A IE 10 IE IE I 
IC |F |C IF |F IS 
|H |1 I |2 |3 n 

IR8-Z16I SUBREGION SIZE IN PRGES 
l-l 



|RB-Z15!V | SUBREGION OISPLACEnENT IM nAIH HEH. PAGES 

IRB-Z14J URITE REOi'EST POINTER 

I- 

IRB-Z13I 



I- 



OBJECT 



ss 

so 

UREQP 
OBJIDENT 



J IDENTIFIER 
I 



-I- 



I 



IR8-Z11I 

| 

IRB-Z10I 

| 

| RB-Z7I LDEV 

| 1 

| RB-Z6I LOU OROER OISC ROORESS 
| 

I RB-Z5I 

, 

I R8-Z4| 

, 

I RB-Z3| 

| 

I RB-Z2I 



HODA 



Henory Hanagenent Tablet 



Global Region Header (Reterved Regiont) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|..|_|-IH--M"M--I--IH--MH"I--I 

IRB-Z30I REGION ASSIGNHENT STATE IRAS 

|A |R |R |C IS IL IF |I |L |H | IB i 

IS IE IV |L II |0 |Z |0 IS |A | |L I 

S IS |A IE |Z |C IN IF |T |P | |n | 

I| |I |R |E IK | |Z |T | | II I 

G I |L IN | | I IH I I I IP I 

REGION SIZE IN PAGES |RS 

ON GOING I/O COUNT |10CNT 



IRB-Z27 



IR8-X26 



HODfl 
LQDfl 



I RB-Z1I 

I- 



IB-Z25 INITIATION HESSAGE 

T IE 10 10 II IE |G in |R |H | 

|X |N |U IN |X |A IS |E IS I 

G IT |G IE |C IP |R |G IL |G I 

G ID |0 IS 10 |R IB |A IP IS | 

L II II IE |R IE IR IB |A |T | 

E IS |N |G |n |Q |G 10 IG |A | 

|A |G |R IS |U IE |R IE |R I 

IB ID |D IV IE I IT | |T | 

IL I I IE I I I I I I 



(INlinSG 



IRB-Z24 ORQ REL ENTRY ADDRESS 



IRB-Z23I COnPLETICN HESSPGE 

IT |n |B IS II in | 

10 10 IL |C |0 IS I 

IG IV |K |H |U |G I 

IG IE ID IE |R !° I 

IL IR IL ID |K |8 I 

IE IE IK |H |E 10 I 



I 
I 
I- 

IRB-Z22I 
I- 

IRB-Z21I 
I- 

IRB-Z20I 
I- 



IQ I 
I I 



IS I 
IG | 



IR I 
IT I 



in 

IS 

IG 

IV 

IA 

IL 

II I 

ID I 



IHITINFO 

IconprsG 



-I 



HAKE PRESENT 0EFERRE0 QUEUE (PCB INDEX) |nP0LINK 
I 

IPAGECNT 
-I 



RELEASE PAGE COUNT 



SPECIAL REQUEST TRBLE PTR (SRT TABLE REL) |SPECF.EQTRBPTR 
I 
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Hemry Ranaqenent Tablet 

Subrtqion Htadtr (Rettrvd Rieiont) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
,.-,..,-.,«l--l-l-l-l-l;-l r l-l--l-l-l- 
|RB-Z17| SUBREGION ASSIGNRENT STATE 

I IC |R |R ID |R I II 

I |R IE 10 IE IE I 

I IC IF |C IF |F | S 

| |H |1 | |2 |3 I _ IT 

IRB-Z16I SU8REGI0M SIZE IN PACES 

|-| 

IRB-Z15IV | SUBREGION DISPLACERENT IN IIRIN RER. PAGES 

|RB-Z14| URITE REQUEST POINTER 

, 

IRB-Z13I OBJECT 

I- 

| IDENTIFIER 

| 1 

IRB-Z11I FREEZE COUNT | LOCK COUNT 

| 1 

IRB-Z10I URITE DISABLE I I/O FROZEN 
| COUNT | COUNT 
, 1 

I RB-Z7I LDEV I HIGH ORDER OISC 
| 1 RODRESS 

I RB-Z6I LOU OROER DISC RDDRESS 

I RB-Z5I 

I RB-Z4I 

I RB-Z3I TIRE OF 
»- 

| RRRIVRL 
| 

I RB-Z1I 

, 



SRS 



SD 

UREQP 

OBJIDENT 

LKFZCNT 
UDIOFZCNT 

HQDA 

LODR 



RRRTIHE 
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2-24 



Renory Ranagtntnt Tablet 



Global R«g*on Htadtr (B iticntd Rteiont) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

|RB-Z30| REGION RSSIGNRENT STRTE 

|R |R |R |C IS IL IF |I |L | IB 

IS IE IV |L IC |K |Z |0 IS I IL 

IS IS I IN | |P |N |F |T | m 

I I I ID | I i IZ IT | II 

I I I I I I I IN I I IP 

| 

IRB-Z27I REGION SIZE IN PRGES 

| 

IRB-Z26I 

, 

IRB-Z25I 

, 

IRB-Z24I 

IRB-Z23I 

| 

IRB-Z22I 

, 

|RB-Z21| 

, 

IRB-Z20I 

| 
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Rtnory Ranagentnt Ttbltt 



Subrtqion Htadtr (Rttiqned Rteiont) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
l-l-l-M-M-M-l-l-M-M-l 



IRB-Z17 SUBREGION RSSIGNRENT STRTE 
I C |R |R |R |R | 
I A IE |0 IE IE I 

C IF |C IF |F | 

H |1 I 12 13 | 



IR8-Z16 



IRB-Z15 V | SUBREGION DISPLRCERENT IN RRIN RER. PRGES ISO 
URITE REQUEST POINTER 



IRB-Z14 
IRB-Z13 

IRB-Z11 
IRB-Z10 

I RB-Z7 

| RB-Z6 

I RB-Z5 

I RS-Z4I 

I RB-Z3 

I R8-Z1 



I I 

I 

I S 

I T 



SUBREGION SIZE IN PRGES 



I SRS 



ss 



OBJECT 
IDENTIFIER 



UREQP 
OBJIDENT 



-I- 



FREEZE COUNT | 

URITE DISRBLE I 
COUNT | 
1- 

LDEV | 
I 
-I- 
LOU ORDER DISC RDDRESS 



LOCK COUNT 

I/O FROZEN 
COUNT 

HIGH ORDER DISC 
RDDRESS 



TWE OF 
RRRIVRL 



LKFZCNT 
UDIOFZCNT 

HOOP 



RRRTIHE 
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Hcnory flanagtntnt Tablt* 



Subrtqion Htadtr (Cached Regional 



1 
l-l- 
|RB-Z17| 
I IC |R 
I IB IE 
I IC IF 
I IH |1 

IR0-Z16I 

1-1- 
IRB-Z15IV | 

IRB-Z14I 

I- 
IRB-Z13I 

I- 

I 

l« 
IR8-Z11I 

I 

I 



2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I — I — I — I — • — I — I — I — I — I — I — I — I — I — I 

SUBREGION RSSIGNHENT STRTE I SRS 

|R |R |R I III 

10 |E IE | I I 

IC IF |F | I S | 

I 12 13 I I T | 



-I 
SUBREGION SIZE IN PRGES |SS 

SUBREGION DISPLRCEItENT IN JtRIN REN. PRGES ISO 

URITE REQUEST POINTER I UREQP 



I- 
I RB-Z7I 

I- 
I RB-Z6I 

I- 
I RB-Z5I 

I- 

I 



OBJECT 
IDENTIFIER 

PREVIOUS CACHED REGION (RDDRESS OF PO 
FIELD OF PREVIOUS CACHED REGION) 



LDEV 



-I- 



-I- 



HIGH ORDER DISC 
RDDRESS 



I RB-Z3I 
I- 
I 
I- 

I RB-Z1I 
I- 






LOU ORDER DISC ADDRESS 

NEXT CACHED REGION (RODRESS OF NO 

FIELD Of KENT CACHED REGION) 
TIRE OF 
ARRIVAL 
DISC RDDRESS &CSL(8) 



-I 

I OBJIDENT 
-I 



IPO 



I HODfl 



I LODR 
-I 
I HO 






lARRTIAE 
-I 
I 



ICACDADISP 
-I 



^ 
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nenory nanagenent Tablet 

Region Headtr and Traily Fftf* Descriptions 

RAS, Region Assignnent State 

.(0:1) Region Assigned Flag 

.(1:1) Region Reserved Flag 

.(2:1) Region Available Flag 

.(3:1) Region Cleaned Flag 

.(4:1) Size Change Pending Flag 

.(5:1) Region Locked Flag 

.(6:1) Region Frozen Flag 

.(7:1) Region I/O Frozen Flag 

.(8:1) LSTT tegnent, Region nap Flag 

.(9:6) Not used 

.(15:1) Blocked Lock Higration m Progress Flag 

IOCMT, On-Going I/O Count 

* ft of on-going I/Os in the region uhich nust conplcte 
before the initiation nessage can be processed. 



IHITHSG, Initiation nessage 



IHITINFO, 



.(0:1) nessage Processed Toggle Switch 

.(1:1) nessage Externally Disabled Flag 

.(2:1) nessage On-going I/O Disabled Flag 

.(3:1) Queue Segnent Read Disc Request Flag 

.(4:1) Incore ttove Request Flag 

.(5:1) Expansion Request Flag 

.(6:1) Garbage Collection Flag 

.(7:1) nessage Aborted Flag 

.(8:1) Release Residual Pages Flag 

.(9:1) OK To Start Conpletion Flag 

.(15:1) nessage Valid Flag 

Initiation nessage Auxiliary Information 

* DRQ relative index of segnent read disc request if 

IMITnSG.QREADREQ "1 

QRERDREQ * ♦/- Displacement to initiation nessage for noves 
and expansions. 



COHPnSG, Conpletion nessage 



.(0:1) nessage Processed Toggle Suitch 

.(1:1) Segnent nodification Required 

.(2:1) Block Lock Request 

.(3:1) Send Scheduler A nessage 

.(4:1) Auaken A Device 

.(5:1) nessage Aborted 

.(6:9) Available 

.(15:1) nessage Valid Flag 
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nenory nanagenent Tablet 



ND, Next cached donain link for caehed donain regions 
only. Containt the abtolutc address of the NO field 
of the next cached region. (2 uordt) 

ARRTME, Arrival tine, containt the tine at uhich the tegnent 
contained in the region becane pretent 

CACDADISP Valid only for regiont containing a cached donain, 
thit uord repretentt the ditc address (in one uord) 
of the eegnent contained in the region. Thit uord 
uhich exittt in each nenber of a linked litt of cached 
donamt, it uted at the target uord during the LLSH 
instruction. 



Space Allocation Structure 

At of I1PE V/P and V/E, one doubly linked litt structure is used instead of 
the nultiple lists ordered by size as in HPE IV. SysGlob locations Z250 
through X253 contain the respective head and tail (bank & address) of the 
available region list. These four uords have in essence replaced the RRSBH 
and ARL data structures in nPE IV. nenory allocation and deallocation is 
handled through PUTONARL and TAKEOFFARL. The search for an available region 
of the desired size is done via the LLSH inetruetion. The fornat of the litt 
it the following : 

SytGlob Z250 & X251 pointt to the abtolute address of the NEXT LINK 
field (tuo uordt) in the firtt available region on the list. The 
NEXT LINK field in the firtt available region pointt to the 
abtolute addrett of the NEXT LINK field in the tccond available 
region and to on. It it uorth ncntioning that in addition to 
having a NEXT LINK field, each available region also contains a 
PREVIOUS LINK pointer, uhich naket nanagenent of the litt both 
eatier and fatter. 



nenory nanagenent Tables 



nPQUNK PCB relative index of the HEAD of the nake present 
queue. 

PAGECNT, Release Page Count 

* * of extra pages to release before processing initiation 
nessage. 

SPECREQTABPTR, A Special Request Table relative index to the list 
of devices queued on this segnent. 

SRS, Subregion Assignnent State 
.(0:1) Cached region 
.(1:1) Referenced 
.(2:1) Recover Overlay Candidate 
.(3:1) Reference 2 

(4:1) Reference 3 

(13:3) I/O Status fron region fetch 

SS, Subregion Size (in pages) 

SD, Subregion Displacenent 

.(0:1) Displacenent Count Valid Flag 
.(1:15) N Pages to Base of Region 

UREQP, Unte Request Pointer 

= DRQ Relative Index of Disc Urite Request uhen the 
Data Segnent in the Subregion is in notion Out 
Uhen the region belongs to a cached donain uhich 
is napped (i.e., OBJIDENT * 30000/non zero nunber) 
this uord is non zero. If the cached donain is not 
napped UREQP is zero. 

OBJIDENT, Object Identifier - has standard object identifier fornat 

LKFZCNT, Lock and freeze count 

.(0:8) Nunber of tines region has been frozen 
.(8:8) Nunber of tines region has been locked 

UDIOFZCNT, I/O freeze count 
.(0:8) Not used 
.(8:8) Nunber of tines region hat been iofrozen 

For regiont belonging to cached donaint, the above tuo uordt 
contain the absolute address of the PD field in the previous 
region belonging to a cached donain. 

HODA, High order diec addrett in virtual nenory of thit 
region 

LODA, Lou order ditc addrett in virtual nenory of thit 
region 
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Ditc Layout 



CHAPTER 3 DISC LAYOUT 



Svtten Ditc Layout 



SECTOR » | 
Z 



C 



DISC LABEL 



-ISECTOS « 



DEFECTIVE TRACKS/SECTOR TABLE 



COLD LOAD CHANNEL PROGRAH FOR HP-IB 



nEn ounp channel prograh for hp-ib 
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CODE FOR 

INITIAL PROGRAM 

"BOOTSTRAP" 

SEGHENT 



10 
-I 

11 
-I 

12 

3 

4 \ 

I 
15 i 

I 
6 I 

I 
|7 I 

I 

8 I 
I 

9 I 



LOU CORE (CST POINTER, QI. ZI, POINTER) 



TEnPORARY CST (INITIAL PROGAAH) 



INTERNAL INTERRUPT HALTS 
BOOTSTRAP STACK 



REHAINDER OF SIO COLD LOAO PROGRAM 



> VARIABLE 
| LENGTH 

I 
I 
I 
I 
I 
I 
I 
I 
I 
/ 

<— \ FOLLOUS 
I MEDIATELY 
| AFTER 
| BOOTSTRAP 
I SEW1ENT 



1 
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Oitc Layout 



Svitm Ditc Layout (Cont. ) 



SECTOR « I 1 SECTOR I 

1 1 ! : 

34| DISC COLD LOBO INFORHATION TABLE 128 

| 1 

351 DISC COLD LORD INFORMATION TABLE 129 

| I 

361 DISC COLD LOAD INFORMATION TABLE 130 

| 1 

37| SYSDUHP/INITIAL CQfMUNICATION RECORD 1 31 

, 1 

401 DISC COLD LOAD INFO. TABLE EXT. | 32 

, 1 

41| DISC COLD LOAD INFO. TABLE EXT. |33 

f ~*~ " I 



SYSDB I- 
I 



Z1 30/1 31 1 

i 
I 



SYSTEIt DIRECTORY 



VIRTUAL HEHORY AREA 






-> NOTE: INITIAL 
TRIES TO 
ALLOCATE 
DIRECTLY AFTER 
THE FREE SPACE 
HAP. KOUEVER. 
THIS HAY 
VARY DEPENDING 
ON DELETED 
OR REASSIGNED 
TRACKS 



I INITIAL PROGRRH SEGMENTS 
I (EXCEPT BOOTSTRAP SEG) 



SYSTEB FILES 

(FROn COLD LOAD TAPE) 



VOLUHE TABLE 

INITIAL PROGftRH STACK 
REHAINING INITIAL CODE SEGHENTS 



USER FILES 



■—I 
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Ditc Layout 



Sv.fn Volant (Cont.) 



I I- 



I 311 UCSLE1.PU8.SYS High Ordtr Ditc Rddrttt 



I 32 1 UCSLE1.PUB.SYS Leu Ordtr Ditc Rddrttt 

I " 

I 

I 



33 1 UCSLE2.PUB.SYS High Ordtr Ditc Addrttt 



DISC FREE SPACE HUP OK FLAG 



I- 
34 1 UCSLE2.PU8.SYS Leu Ordtr Ditc Addrttt 

I- 
35] 

RESERVED 



170 
171 
172 

173 

174 
175 
176 
177 



-I 

1 25 *HICRO/XE 
-I UCS WAGE 

1 26 POINTER 

|27 *HICRO/LX/GX 
-I UCS WAGE 

1 28 POINTER 
-I 

1 29 



DISC FREE SPACE HAP DESCRIPTOR 
TABLE CHECKSWI 



DISC FREE SPACE DESCRIPTOR TABLE 
DIRTY FLAG 



120 
121 



122 



123 



DISC FREE SPACE DESCRIPTOR 
TABLE ADDRESS 



DISC FREE SPACE BITHRP ADDRESS 



124 
125 



126 
127 



I * UCS inagt pointtrt point to the start of tht UCS 

I data (Filt iabtl addrttt ♦ 1). Aluayt on LDEV 1. 

| ** At of V-Dtlta-5 (6.03.05) tht uay tht COLDLORO ID't art 

I uttd hat bttn changtd. A Volunt ttt ID (VID) hat bttn 



crtattd to logically link togtthtr a ttt of ditct. Oriainaily 

tht COLDLOAO ID ptforntd thit, at utll at tnabling tht FILE 
SYSTEH to ttll if tht filt uat optn uhtn tht tytttn failtd. 
Tht VID it NOT changtd en tach tytttn start, only on a RELOAD. 
In ordtr to naintain backward eonpatibility, tht old COLDLOAO 
ID locationt havt bttn changtd to ROLLBACK COLDLOAO ID't. Tht 
actual COLDLOAO ID (for FILESYS) it in tht Ditc Cold Load info 
Tablt (DCLT) word 46 (Z56). 
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Disc Layout 



Ditc Label (S tctor of Due) 



Svatttt Volunt 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
0| o 



I I- 
I 3! 



UOROS 0-5 CONTAIN 
THE ASCII STRING 
"SYSTEH DISC " FOR 
THE SYSTEH DISC, 
ONLY. 



15 
— I 
I DISC TYPE | DISCSUBTYPE | 6 

"rOLLBACk'cOLD LOAD ID "SEE NOTE BELOU" |7 



-I- 



"3" 



5| 
I I- 

6| 
I I- 
I 7| 
I I- 
I 101 
I I- 
I 111 
I I- 
121 
I 
131 
I 
141 
I 
151 
I- 
I 161 
I I- 
| 17| UNUSED 

I I 

| 201 VOLUHE SET ID 
I I- 



-I- 



-I- 



I 



,. H 



'I 

18 



VOLUHE NRHE 



UNUSED 



"SEE NOTE BELOU" 



HO 

I 

111 

I 

112 

I 

113 
-I 

114 
-I 

115 
-I 

116 
-I 



IF UORO Z11 
CONTAINS A T 
A FORHER SYSTEH 
VOLUHE HAS BEEN 
SCRATCHED. 



UNUSED (uordt 17-20 (Z21-Z24) UNUSED] "17-20 



21-24" . _..__. 

, | 1 

I 25 | SYSUCS64.PUB.SYS High Ordtr Dxtc Addrttt 121 



I I- 



-I 



j 26 j SYSUCS64.PUB.SYS Leu Ordtr Ditc Addrttt I 22 
, | 1 

| 27| SYSUCS37.PUB.SYS High Ordtr Ditc Addrttt |23 

j | j 

| 301 SYSUCS37.PUB.SYS Lou Ordtr Ditc Addrttt 124 

, 1 
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*6X/70 UCS 
WAGE 
POINTER 

*37 UCS 
MAGE 
POINTER 



Ditc Layout 



jtrjal Volunt 



COLDLOAO SIO CHANNEL PROGRAfl (NON-HP-IB 
HACHINES ONLY). FOR HP-IB HACHINES, COLD 
LOAO CHANNEL PROGRRH IS IN SECTOR 2 AND 

4| SOFTDUflP CHANNEL PROGRRH IS IN SECTOR 3. 
111111 

501234567890123455 

6 SCIHViSRI | TYPE IHEDIA TYPE* 6 



7 
10 
11 
12 
13 
14 
15 

16 
17 
20 
21 
22 1 



(: STORE) 
OR 



1- 

-r i 



-I- 
l 

-l— 
» 
I 
— 1~ 

UORDS PER SECTOR 



•r 

M C" 



SOISC VERSION 
NUHBER 



I- 
24 1 
I I- 



SECTORS PER TRACK (CARTRIDGE TAPE • 1) 
SECTOR ADORESS OF BEGINNING OF TRPE (60T 
DOUBLE ADDRESS OF 

END OF TAPE (EOT) 
DOUBLE ADDRESS OF 

END OF DATA (£00) 



SC ■ 1 » 

SCRATCH VOLUHE 
HV • 1 « RASTER 

VOLUHE OF PV SET. 
SR « 1 * 

SERIAL DISC 



|25| SYSmCS64.PUB.SYS High Ordtr Ditc Addrttt 

| , 

|?6| SY?UCS64.PUe.SYS Lou Ordtr Ditc Addrttt 
I I- 



10 \ 

11 | VOL HAHE 

12 I "SERDISC" 
I 

13/ 

14 \ 

'.si 
I 

116 | 

I SERIAL 
17 > DISC 

I INFO 

118 | 
I I 

119 I 
I I 
120/ 
I 

121 ICF UCS 
I WAGE 

122 POINTER 
I 



G.23.00 
3- 5 



Disc Layout 



?er^t Vplune (f.on^ T ) 



I- 



J27] (Set SYSTEfl VOLUHE uords M5-X34) 
RESERVED FOR FUTURE UCS 



I 
1221 



I- 
1231 



124| 



CYL 
HERD 



-I- 



SECTOR 



]23 

182 
-I 

183 
-I 

184 
-I 



* HEDIA TYPE is the device subtype for ell serial volunei except cartridge 
tape. For cartridge tape, this field it always (the HP 9110 subtype), 
despite a different actual cartridge tape subtype. This allous both 
forward and backward intcrchangeability of cartridges betueen the HP 9110 
and HP 9144. 



Haste r Volune 



SC > SCRRTCH 

VOLUHE 

j flV * RASTER 

VOLUnE « 1 

SR * SERIAL 

VOLUHE 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l- 

Ol 

11 

21 

31 

41 

51 _ I .. ... 

eiSCIfWlSRl" """ I TYPE I SUB-TYPE 
l-l-l-l 1 1 

7| GENERATION INDEX 
| 

101 

111 
, 

121 

13| VOLUHE 
14| NRHE 
151 
| 

16| INITIAL DATE 

, 

17| DIRBASE 

201 DIRSIZE 

| 

211 

221 ACCOUNT 

231 NAHE 

241 

| 
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18 
9 

10 
11 
112 
13 

14 



16 

17 
18 
19 
20 



0«NOT 
RASTER 
VOLUHE 



Disc Layout 



Raster Volune (Cont.) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



l-l-l-l-l-l-l-l- ...... 

25| 121 

26 1 GROUP 1 22 

27 1 NAHE 1 23 

32; VOLUHE SET 1 26 

33 1 NAHE 1 27 

j 34 | I28 

| | 1 

| VS VTAB 35 1 1 29 

I HEADER ♦ I 1 1 

| 8 ENTRIES 36 1 VCOUNT | I VHASK 1 30 

COPIED FROH | 1 1 1 

VSET OEFN 37 | 131 

IN SYSTEfl 401 VOLUHE 132 

DIRECTORY 41 1 NAHE 1 33 

42| I34 



/f^N 



Disc Layout 



Slave Volune 

| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I I — I — I — I — I — I — I — I — I — I — I — I — I — I — I — I — 

1 01 

11 

21 
31 
41 
SC s SCRATCH 51 

VOLUHE I -I - 1 - 1 1 1 

HV * RASTER 6|SC|HV|SR| I TYPE I SUB-TYPE 



VOLUHE " 

SR ' SERIAL 7 

VOLUHE 

101 
11 

12 
13 
14 
15 

16 

17 
20 

21 
22 1 
23 
24' 

25 1 
26 1 
27 
30 

31 
32I 
33 
34| 
I 



-j.-j.-j 1~ 

GENERATION INOEN 



-I- 



VOLUHE 
NAHE 



INITIAL DATE 



ACCOUNT 
NAHE 



GROUP 
NAHE 



VOLUHE SET 
NAHE 



no 
11 

12 
13 

14 

15 
16 

17 
18 
19 
20 

21 
22 
23 
24 



VOLUHE 
ENTRY 



I- 
43| 



SUB- TYPE 



VTRBX 



45| 



I 
1161 



1 

135 
1 

136 
1 

137 

I 



178 



VOLUHE 
ENTRY 

7 



I- 
1701 

I- 
1711 

I- 
1721 

I 

I- 
173| 

I 

I- 
174| 

I- 
175! 

I- 
1761 

I- 
177| 

I — 






1120 



DISC FREE SPACE m OK FLAG 



DISC FREE SPACE DESCRIPTOR 
TABLE CHECKSUfl 



1121 
-I 
(122 



DISC FREE SPACE DESCRIPTOR TABLE 
DIRTY FLAG 

DISC FREE SPACE DESCRIPTOR 

TABLE ADDRESS 

DISC FREE SPACE BITHRP ADDRESS 



1123 



1124 
-I 

1125 
-I 

1126 
-I 

1127 
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Slave Vnluni (Cont.) 



I- 
1701 

I- 
1711 

I- 
172! 

I 

I- 
1731 

I 



Disc Layout 



1120 



DISC FREE SPACE IffiP OX FLAG 



DISC FREE SPACE DESCRIPTOR 
TABLE CHECKSUfl 



1121 
-I 
1122 



I- 
174! 

I- 
1751 

I- 
1761 



DISC FREE SPACE DESCRIPTOR TABLE 
DIRTY FLAG 



-I 
1123 



DISC FREE SPACE DESCRIPTOR 
TABLE ADDRESS 



- I 



1124 



I- DISC FREE SPACE BITHAP ADDRESS 



177| 
I- 



1125 
-! 
1126 
I 
1127 



25 

26 
27 
28 



0.23.00 
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Disc Layout 



Defective Tracki Table (Sector 1 of Disc) 
(Not Used On CS-80 Discs) 



1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 
.. M ..,.. M ~|--|~I--I--I--IH--I--M--I 

• OF DEFECTIVE TRACK ENTRIES (N) |0 
1 1 

DEFECTIVE TRACK NUHBER I DTC |1 120 DEFECTIVE 
| | TRACKS nAxinun 



DEFECTIVE TRACK NUI1BER 



1701 DEFECTIVE TRACK RUBBER 



1711 



1721 

I 
1731 

I 
174| 
I I- 
I7SI 
I I" 
1761 NEXT AVAILABLE ALTERNATE TRACK 

177| LOGICAL DISC PACK SIZE (CYLINDERS) 
I 



RESERVED FOR 
FUTURE USE 



CHECKSUfl 



I DTC 12 
-I 1 

I 



I 
1 1 

I DTC 1120 
1 j 

1121 

I 

1122 

I 

|123 

I 

1124 

1125 DTTCKSUd 



-I 

1126 
-I 

1127 



OR « Of TRACKS IF FH DISC 

DTC (DEFECTIVE TRACK CODE) 

susptct 

1 suspect alternate 

2 deleted 

3 reassigned 

NOTE: The situation uhere there »n tuo entries For the sane track, n, one 
having a DTC of (suspect) and the other having a DTC 3 (reassigned) 
results fron a situation uhere the dise driver could not "read" 
(unreadable) the address of the particular track. 

I DTTCKSUft (Systen Volunes only): I This is an EXCLUSIVE -OR 
checkeun(fron a base of -1) of the DTT I excluding word Z175. 
Each tine a suspect track is inserted or | nodified, a neu 
chscksun is calculated and stored in uord Z175. I At systen 
startup INITIAL recalculates the checksun and conpares I against 
original value at Z175. If the checkuns do not natch I a 
COliLOAO ERROR 202 (HOUNT CORRECT V0LUI1ES OR RELOAD) uill occur. 

G. 23.00 
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Disc Layout 



Defective Sector Table (DSCT -- Sector 1 of Disc) 

Justs On Device Type 3 (CS-80) Discs, Except Cartridge Tape) 



(The OSCT Exists 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

, H ..,.-|--|--I~I--I--I--I--I--I--M--I--I--I 

01 NUHBER OF ENTRIES IN THE TABLE 10 



I- 
11 1 



Z2I 

I 



INOEX TO THE FIRST ENTRY (6) 
ENTRY SIZE (2) 



(^ 



Z3| HAXinun NUHBER OF ENTRIES (Z75) 

I- 
Z4| 

I- 



(RESERVED) 



FIRST DEFECTIVE SECTOR ENTRY 

(DQU8LE-U0RD LOGICAL SECTOR ADDRESS) 



ZS| (RESERVED) 

I- 
Z6| 
Z7| 

I- 
I10| 
Z11I 

I- 
I12| 
Z13I 



SECOND ENTRY 



THIRD ENTRY 



I __ _ 

Z176I "nAxmun defective sector entry 

Z177| 



1126 
1127 



1 



Unlike the DTT, entries in the DSCT *rt not permanent. Once a suspect sector 
is handled by INITIAL, SDISC, or VINIT, its entry is renoved fron the table. 
Thus, this table contains only unprocessed suspect sectors. 
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Disc Layout 



Reserved Area Bit flan (Sector 4 of the Svsten Disc) 

The first 400 sectors of the systen disc are reserved for Initial's use. 
This area contains pernanent data structures for the boot. It is also used 
as a tenporary storage area for data during eparing. All other systen 
volunes and private volunes reserve only the first 10 sectors of the disc. 
They do not have a reserved *rt* bit nap. 

The bit nap contains 1 bit per sector. A M* ncans the sector is free. 



Disc Layout 



101 



-I 



RESERVED AREA 
BIT flAP 



Z30 
Z31 



Z177I 



I24 



1 



RESERVED FOR 
FUTURE USE 



I25 



1127 

-I 



Disc Cold Load Information Table (Sectors Z34-Z36) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

IH-I~M-M-M-M-I-M~I-I 
01 POINTER TO TABLE INF0RI1ATI0N 



1 

2 

3 

4 

5 

6 

7 

10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 

261 

I- 
271 
I I- 



POINTER TO TEltPORRRY CST INFO 



• OF ENTRIES TO READ ON DISC COLD LORD 



• OF CODE SEGHENTS IN INITIAL 



INITIAL'S DB VALUE 



INITIAL'S OL VALUE 



INITIAL'S Z VALUE 



INITIAL'S Q VALUE 



INITIAL'S S VALUE 



-I- 



-I- 



I SYSDISC TYPE I SUBTYPE 



-I- 



-I- 



ROLLBACK CQLDLSRD ID "Set note below** 



LOG FILE NUJ18EA 



DIRECTORY DISC 
ADDRESS 



LDEV 1 VIRTUAL RERORY 
DISC ADDRESS 



• LOGPROCS 



LOG ID'S 



RIN TABLE 

DISC ADORESS 



DIRECTORY SIZE 



•SECTORS IN VIRTUAL REnORY REGION 
OF LDEV 1 



VOLUItE SET ID (VID) "See note below" 



RIN TABLE SIZE 



OXRAOt 

VIRIIEnROOt 

NLOGPROCS 
LOGIDS 

RINflDR 

OIRSECT 

SECTORS IN LDEVIVfl 
VIRflEttSECT 



>^ 



RINSECT 
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Disc Layout 



Chic Cold Lo »d Information Table (Cont.) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

i — i — i — i — i — i — i — i — i — ■ — i — ■ — • — ■ — ■ — ■ — !-«« 

30 1 * OF RIMS RIMS 

j 1 

311 ft OF GLOBAL RIMS l^fLc rm* .non 

I I— I — I — I Tl«TAPE COLO LORD 

32 |TL|RL|RY|LORD MODE 

| 1 - 1 - 1 - 1 RLsRELORD 

| | RY=RECOVERY 

331 MAX VOL I HIGH VOL IH'VOl' 

| 1 1 

34| DISC COLD LORD ENTRY POINT IOISCENTRY 

I 1 

351 SYSTEfl DISC DRT NUMBER ISYSOISCDRT 

j 1 

361 JOS flfiSTER TABLE I 



I 
37| 



DISC ROORESS 



IJMRTLOC 



I- 
401 

| 100 OISC ROORESS 
411 

| 

421 

| ODD DISC RDDRESS 
431 

44| UELCOHE MESSAGE (DST Z57) 

I 
451 OISC RODRESS 

461 UELCOHE MESSAGE (OST MO) 

I 
47| DISC RDORESS 

| 

501 

I LOG ID ROORESS 
511 

| 

521 

I LOG TAB ADDRESS 
531 



IDDLQC 



OODLOC 



I- 
54| 



LOG ID SIZE 



I- 

551 LOG TAB SIZE 
| 

561 COLDLORD ID 
I 



**See note belou** 



LOG0NL0C1 



L0G0NL0C2 
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Disc Layout 



SIZE IN UORDS 
MEMORY RDDRESS 



Diic Cold Load Information Tablt (Cont J 

|FREFTR*25 



DISC ADDRESS 
SIZE IN UORDS 
MEMORY RDORESS 



cornnmiM- 

SUBSYSTEfl 
TABLE 



LOGICAL- 
PHYSICAL 
DEVICE 
TABLE 



FAEFTR>30 



DISC ADDRESS 



SIZE IN UORDS 



MEMORY RDDRESS 



LOGICAL- 
DEVICE 
TABLE 



DISC ADORESS 



SIZE IN UORDS 
MEMORY RDORESS 



FAEFTROS 



FA£FTR*40 



DISC ADDRESS 
SIZE IN UORDS 
MEMORY ADDRESS 



DEVICE 
CLASS 
TABLE 



VOLUME 
TABLE 



IFAEFTR+4S 

I 



DISC ADDRESS 



—| 
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Ditc Cold Load Information Tablt (Cont.) 



1 



SIZE IN UORDS 



MEMORY RDDRESS 



•DRIVER 
TABLE 



|FBEFTR«0 

I 

I 

I 



Disc Layout 



I 
/ 



DISC ADDRESS 



SIZE IN UOROS 
MEMORY ADORESS 



DISC RDDRESS 



SIZE IN UORDS 
MEMORY RDDRESS 



*CTRB 



I 
-I 
IFREFTR+5 
I 
I 
I 



I 
-I 
|FREFTR»10 
I 
I 



DISC RDDRESS 



SIZE IN UORDS 
MEMORY RDDRESS 



conrtUNicfl-| 



|FAEFTR*15 



HON SUB- 
SYSTEH 
DRIVER 
TABLE 



DISC ADDRESS 



SIZE IN UOROS 



MEMORY RDDRESS 



DISC RDDRESS 



connuNiCR-l 

TION SUB- I 
SYSTEfl | 
DEFINITION | 
TABLE 1 

I 
I 



I 
I 
I 

I 
I 
I 
I 
-I 
IFAEFTR+20 
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Disc Layout 



Ditc Cold Load Information Table (Cont.) 



SIZE IN UORDS 
flEHORY RDDRESS 



DISC ADDRESS 



I 

LOGICAL I 
DEVICE I 
TABLE I 

EXTENSION | 
I 
I 



-I 

IFAEFTR+50 



STACK SIZE 



FAEFTR*55 



nEMORY RDDRESS 



DISC RODRESS 
SIZE IN UORDS 
(JEWRY RDDRESS 



INITIAL'S 
STACK 



DEVICE 
CLASS 
TABLE 
HERDER 



FREFTR460 



DISC ADDRESS 
SIZE IN UORDS 
MEMORY RDDRESS 

DISC ADDRESS 
SEGMENT SIZE 
MEMORY RDDRESS 

DISC RDDRESS 



TERMINAL 

DESCRIPTOR 

TABLE 



FREFTR«65 



INITIAL/ | 

SYSDUHP | 

COMMUNICATION! 

— RECORO I 

I 
I 



|FAEFTR*70 
I 
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Disc Layout 



Disc Cold Hud Infornation Table (Cont.) 



SEGflENT SIZE 



FAEFTJU75 



flEflCRY ADDRESS 



DEFDATA 
TABLE 
LOOKUP 
- BUFFER 



DISC ROORESS 



|FREFTR*80 



(INITIAL'S SEWENTS) 
IHIN 






1 
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Disc Layout 



SYSDUIIP/Initial Cnnnunication Rteord fSector 137) 



111111 

0123456789012345 

H-l-H-H-H-H-H-M-H 

0| HIT VERSION 

| 

1 1 HIT UPDATE 1 

, 

2| HIT FIX 2 

3 I VERSION 3 

| 

4 | UPDATE 4 

| 

5| FIX 5 

| | 

6 1 EXP. SOFTWARE SYSTEF1 NO. 1 6 
| 

7| HIGHEST DPT |7 

| 

101 HIGHEST LDEV 18 

I I 

111 HRXVOL I HIGH VOL 9 

I I 1 

121 N OF RDD'L DRIVERS 10 

| 

131 COLD LOAD COUNT 11 

| 

14| FILES OUHPED 12 

I !-!-! 



I-I-I- 



151 SERIAL DISC LORD 

161 TAPE RECORD SHE 1 14 

17| DISC COLO LOAD ENTRY 15 

20 I RAX INITIRL SEG SIZE 16 
| 1 

21| SPARE M7 

| 1 

221 SPRRE H8 

| 1 

231 SPARE M9 

24 1 DEV CLASS TR6 SIZE 1 20 

I I 

25| TERH DESCRIPTOR SIZE I 21 

I I 

261 OLD V*R9 SIZE I 22 

I- I 

27| OLD INFO SIZE 123 

I I 



G. 23.00 
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F*>Stt if FOS Sysdunp 



|F|D|S 13 D*>Stt if Futurt Oatt Sytdunp 



S*>Stt if Strial Oisc Sytdunp 









Diac Layout 




PHYSICAL 


JNITIAL Prnqran CST Has 




LOGICAL 






CSTN 


CSTi 


SEGflENT Ngni 







1 


ININ \ 




1 


2 


BOOTSTRAP | > 


Cort Resident 


2 


3 


RESIDENT / 




3 


4 


HAINSEG1 \ 




4 


5 


nRINSEGIR I 




5 


6 


CONFIGURE I 


/Noncore Resident 


6 


7 


DEFCTRACKSI 


I but present in cort 


7 


10 


SETUP I 


>|at conpletion of 


10 


11 


TAPEIO 1 


\Cold Load 


11 


12 


FILEIO 1 




12 


13 


DISCSPACE / 




13 


14 


DIRECT0RY1 




14 


15 


DIRECT0RY2 




15 


16 


SL PROGARFI 




16 


17 


PROCESS 




17 


20 


HAINSEG1B 




20 


21 


HAINSEG2 




21 


22 


nAINSEG3 




22 


23 


RAINSEG4 





•Code segnent swapping starts at conpletion of HAINSEG1 

|*« As of V-0elta-5 (G.03.05) the uay the COLDLOAD ID'S art 

I used has been changed. A Volune set ID (VID) has been 

j created to logically link together a set of discs. Originally 

I the COLDLOAD ID pefomtd this, as uell as enabling the FILE 

I SYSTEH to tell if the file uas open uhen the systtn failed. 

| The VID is NOT changed on each systen start, only on a RELOAD, 

j In order to naintain backward conpatibility, the old COLDLOAD 

I ID locations have been changed to ROLLBACK COLDLOAD ID'S. The 

I actual COLDLOAD ID (for FILESYS) is in the Disc Cold Load info 

I Table (DCLT) word 46 (Z56). This value is put in SYSGL0B(Z75). 
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Oisc Layout 



SYSDUBP/Initial Conmmication Record (Cont.) 



•I-I-I-I-I-I-M-I-H-I-I-I-I- 
CS TABLE SIZE 



TABLE LOOKUP BUF SIZE 

TABLE LOOKUP BUF ENTRIES 

SYSTEH TAPE LDEV • 

SPRRE 

SPRRE 29 

CONVERSION BITS WORD 1 (H 30 



HIT FIX LEVEL INDICATOR ** 
CONVERSION BITS UORO 3 



30 

31 

32 

33 

34 

35 

36 

37 

40 

41 

42 

43 

44 

45 

46 

47 

SO LOG FILE KJJMER 

51 



24 
25 
26 
27 



CONVERSION BITS UORO 4 



SPRRE 
SPRRE 



SPRRE 
SPARE 
SPARE 
SPRRE 



31 
32 
33 

34 
35 
36 
37 
38 
39 
140 



n»(15:1) HPE Version 
O'hPE (G.00.00) 
1*!tPE (G.01.00) 



LAST FULLBRCKUP OUW OATE |41 
1 



«* Rs of V-0elta-5 (G.03.05) uord 31 (X37) of the SYSDWIP/INITIAL 
COIWUNICATION RECORO is nou used as the niT FIX LEVEL INDICATOR. 
It uas previously used as the CONVERSION BITS UORD 2. 

Rs of V-Delta-5 it (uord Z37) uill contain the value Z1 70005. 
The '5* in bits (13:3) is added by INITIAL during the update 
to V-Delta-5 to INITIAL uill knot* that it it using the neu 
COLDLOAD IO/VID nachtnisn. 

Bits (0:4) signal that the following tables have been converted 
to HPE V/E fornat: 

- 10 tables converted. 

1 - Cold Load Info table converted. 

2 - Rin table converted. 

G. 23.00 
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Disc Layout 



3 - Syedunp initial Comtunicatien record. 



^v 
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r 



Oitc Layout 



Virtual Oiac Soace Ranaeenent Structurtt 



Oitc tpact for data segnents it allocattd f ron rtttrved regions of tytten 
voluntt which havt bttn assigned tht virtual nenory tupporting (VHS) 
attribute. Tht data ttructurt uttd for accounting and nanegenent of the 
virtual ditc tpact of tht variout VHS voluntt is tht Virtual Oitc Spact Tablt 
(VDSRTAB). Thit ttructurt consittt of a circular litt of tntries, ont for 
tach VHS volunt. Each tntry containt tht information dtfining tht state of 
tht virtual nenory region on that volune. 



Virtual Disc Soace Ranagenent Table 



VDSRTRB DST» - 39 (Z47) 

VDSRTRBPTR > Rbsolute(Z1026) > SYSGLOB Z26 



general Structure, 



Z1026- 



/ >| 

I /-- 

I I 

I I 

I \-> 

I /— 

I I 

I u 

\ 



« vrs voluhes 
first to look rt 



KEXT IK LIST 



NEXT IN LIST 



NEXT IN LIST 



<-/ 
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Disc Layout 



Cold Load Information Table Extension 



Tht Cold Load Information Tablt Extension is a part of tht Cold Load 
Information Tablt that has no ust in booting the tytttn. It exists for 
different systtn level processes to hold information that uould only bt 
created during a RELOAD. R good txanplt of thit it tht tytttn log filt 
nunbtr. This is only created on a RELORD, and changed whenever a log file it 
'ull or a boot (other than a RELORD) is performed. 

In order to protect tne Cold Load Info Table, the extension uas created. In 
this uay no I/Os should be perfomed to the Cold Load Information Table 
during RPE operation. Houever to process data into the Cold Load Info 
Extension a process nust use the access routine "PROCESS' COLD' LORD' INFO". 
The exact calling sequence can be found in KERNELD. 

The Cold Load Information Extension is 2 sectors long and immediately follows 
the SYSDunP/Initial Communication Record starting at ttctor addrtts #31 on 
logical devict 1. Tht atsigntd tntritt art as follows: 



SjcjorMO 



I— 
01 

I- 
11 

I- 
21 



I- 
I 241 



RESERVED FOR FUTURE SYSTER USE 



I 261 

I 
I 271 

I 
I »l 

I 
I 311 

I 
I 321 

I- 



SYSTErl LOGGING FILE NUflBER 


NETUORK RRNRGERENT LOGGING FILE NURBER 


NETWORK RANAGERENT TRRCE FILE NUR6ER 


FULL/PRRTIRL COnnRND DURP DRTE 


ZZZZZZZZ1JZZ 



331 NOT CURRENTLY ASSIGNED 

I- 
34| 

I- 



I- 
I 377| 



I- 



-I 

120 

I 

121 

I 

I22 

I 

I23 

I 

I24 

I 

I25 

I 

I26 
-I 

I27 
-I 

I28 
-I 



1 255 
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Ditc Layout 



VDSRTRB Entry Fornat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I — I — I — I — I — I — I — I — I — I — I — I — I — I — I — l- 

VDSnTRBOOl « UORDS IN VDSRT 



VDSIURBOI 

VDSRTRB02 
VDSRTRB03 
VDSRTRB04 
VDSRTRB05 
VDSnTRB06 
VDSI1TRB07 



N SYSTER VOLUHES UHICH HRVE 
VIRTUAL RERORY 



INDEX OF NEXT ENTRY TO RLLOCRTE FROR 



Vfl PRGE SIZE (512) 

« SECTORS/VR PRGE (4) 

OFFSET FROR ENTRY TO BITRRP (Z20) 



TOTRL N VR PRGES CONFIGURED IN SYSTER 



LEAST « OF VR PAGES THAT HAVE 
EVER BEEN AVAILABLE 



TABLE LENGTH 
VRSVOLURECMT 

STRRTENTRY 
VRPRGESIZE 
SECTQRSPERVRPRGE 
0FFSETT08H 
** See belou 



VDSRTRB Z10-Z17 UNASSIGNED 



** Thit 16 bit field can only acconnodatt 32K Paget or 255K sectors. 
Each vclune can have up to 255K sectors of virtual ntnoty. Thie 
uord uill overflow if there are nore than 255K total VR pages 
configured en all tytten disct. RPE dott not utt thit uord. It 
instead uses the general VDSMRB entry for tach volune to find out 
the total virtual neiory sectors on a particular volune. 
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VPSflTRB Gentr^ Entry Forwat 

WW Z 1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 

M .-|--I~I--M--I"I--I--I"IH--IH--I 
INDEX OF NEXT ENTRY IN CIRCULAR LIST 



LOEVN 



STARTING SECTOR OF OEVICE'S 
VIRTURL RERORY REGION 



tt SECTORS IN OEVICE'S 

VIRTURL REflORY REGION 

TpRGES IN OEVICE'S VIRTUAL RERORY 
REGION 



N OF PRGES RVRILRBLE IN OEVICE'S VH 
REGION 



M OF VRUD UOROS IN OEVICE'S BIT RRP 
SIZE OF SRRLLEST RECENT HISS 



NEXTINUST 

LDEV 

KOSTRRTSECTOR 

LOSTRRTSECTQR 

TOTAL SECTOR 

COUNT 

TOTRL PRGECNT 

PRGESAVAILABLE 

BRLENGTH 
SRALLESTRISS 



SRRLLEST NURBER OF PRGES EVER RVRILRBLE I 
UKRSSIGNED I 



OEVICE'S VIRTURL REHORY BIT I 



«**COHRENT: R bit on in a device's Vfl BIT RRP 
« Corresponding VH pagt is frit. 
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Typiwi p rjv«tt Vfflw E"tnr 



I 



151 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
—I — I — I — I — I — I — I — I — I — I — I — I — I — I — • — 



vouunE 

NRRE 



GROUP 
NRRE 



RCCOUNT 
RARE 



1- 

LOGICAL DEVICE I I 
(«© IF NOT ROUNTEO) I 

IVSET VTRSX | 



IVRIUNINSISC 

III' 



INDEXED BY 
VOLURE • 



2 

3 

4 
5 

6 

7 



8 

9 

10 

11 Vfl - VIRTUAL RERORY 
SUPPORTING 

UN - UNRERDRBLE/ 

12 UNFORRRTTED 
NS - NON-SYSTEH 

DORRIN 

13 SC - SCRATCH 



Disc Layout 
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Volune Table 



SIR »22«X26 
DST «29*Z35 



Zero Entry 



OCTAL 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 OECIRAL 
UOROI — I — I — I — I — I — I — • — I — I — I — • — i — I — I — ■ — lt*OitO 

| N OF ENTRIES (NOT | I 

0| COUNTING I ENTRY SIZE*X16 10 

I ZERO) I I 

| 1 1 

1| ROLLBACK COLD LOAD 10 **See note belou" |1 

2| NUHBER OF VOLURES 12 

| | 

31 ROLLBACK VIRTUAL RERORY INTEGRITY NURBER 13 

| 1 

4 1 VOLURE SET ID "See note belcu" | 

| 1 

5| VIRTUAL RERORY INTEGRITY NURBER ** I 

| 1 



<^*W|\ 



151 



113 



** As of V-Delta-5 (G.03.0S) the uay the COLDLOAD ID's art 
used has been changed. A Volune set ID (VID) hat been 
created to logically link together a set of discs. Originally 
the COLDLOAD ID pefomed this, as uell as enabling the FILE 
SYSTER to tell if the file was open uhen the eysten failed. 
The VID is NOT changed on each systen start, only on a RELOAD. 
In order to naintain backward conpatibihty, the old COLDLOAD 
ID locations have been changed to ROLLBACK COLDLOAD 10* s. The 
actual COLDLOAD ID (for FILESYS) is in the Disc Cold Load info 
Table (DCLT) uord 46 (Z56). 
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Typical Svsten Volune Entry 



I 



151 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
-M-M-I-MH-M-I-I-M-IH 



INOEXED BY 
VOLURE • 



VOLURE 
RARE 



STRRTING SECTOR OF VOLURE' S VR 
(0 IF NONE) 



12 
3 
4 
5 

6 
7 
8 
9 



NURBER OF SECTORS RESERVED FOR 1 10 
VR ON VOLURE 
(0 IF NONE) 

, I--M--I 

LOGICAL OEVICE • I |VR|UN|NS|SCI 

(' IF NOT ROUNTED) I I I I I 

, , I--IHH 

IVSET VTRBX | RVTR8X 
I 



11 Vfl - VIRTUAL RERORY 
SUPPORTING 
UN - UNRERDRBLE/ 
|12 UNFORRRTTED 
NS - NON-SYSTEH 
DORRIN 
13 SC - SCRATCH 



""V 
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Directory 



r 



CHAPTER* DIRECTORY 

Introduction to the Directory 

SYSCLOB cells: 

DIRBRSE < absolute disc addr of bast (SYSGL0B*X130 RND Z131J 

Directory on disc consists of a contiguous »rt»: 



DIRBRSE • 






I 

l~ 
OIRBASEO -> I 

I 
I 
I 
I 
I 



DIRECTORY 
BITHRP 



DIRECTORY 
DATA 



ENTRIES 

AND 

INDICES 



The bitnap defines the available/used 
sectors in the directory. If the 
directory is < 6112 sectors, then 
the bitnap uill occupy 3 sectors. 
If the directory size is > 6112 
sectors, then the bitnap uill occupy 
32 sectors uith DIRBRSE pointing to 
the 30th sector of the bitnap. A 
zero bit in the bitnap represents a 
used sector. Uords and 1 of the 
bitnap are ignored. 



Directory entries contain pointers 
uhich are sector displacenents 
relative to DIRBRSE. Entries and 
indices are grouped into "blocks". 



I— ' 



The capacities for accounts/groups/users/files are dependent on their 
block sizes. 

* SYSSRI8SIZE Systen acct index block size (3 sectors) 
SYSRUIBSI2E Acct. user index block size (1-3 sectors) 
SYSRGIBSIZE Acct. group index block size (1-3 sectors) 
SYSOflBSIZE Croup file index block size (2 sectors) 
SYSGVSIBSI2E Croup volune set definition ind. blk. sized sector) 

* SYSAEBSIZE Acct. entry block size (3 sectors) 
SYSUEBSIZE User entry block size (2 sectors) 
SYSGEBSIZE Group entry block size (2 sectors) 
SYSFEBSIZE File entry block size (2 sectors) 
SYSVSEBSIZE Volune set definition entry block size (1 sector) 
SYSRAXBSIZE flaxinun of above, (used to initialize DOS.) 

*These values are used once for the creation of the (root) systen, 
account index or neu systent. This root index is aluays at address 
DIRBRSEO. 
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Overview of Directory 



| 1 

I SYSTEA | 

/ / \ \ 
/ / \ \ • - • 

ACCOUNTS I — I I — I 

I I I I 
I I I I 
I — I I — I 
/ \ 
/ \ 

/ \ 

/ \ 

I I 1 I 1 

| | USERS | | GROUPS I 

I 1 I 1 

/ / \ / \ \ 

I I \ I \ \ 

l-l l-l - I-I l-l l-l 

I I I I I I I I I I 

till I I I I I I GROUPS 

|-| I--I l-l l-l I--I 

* .' 

USERS / \ 
/ \ 
I 1 I 1 

I VSETS I I FILES I 
I 1 I 1 

/ I I \ 

I I I \ 

I I I \ 

l-l l-l l-l l-l 

VSETS/ || I I I I I I FILE 

KEY: VCLASSES II I I I I II POINTERS 

I 1 l-l l-l l-l l-l l-l 

I I I I / 

I 1 I I / 

INDEX |~| / 

ENTRY FILE 
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Directory 



Directory Data Seonent 



Oh 
.I 



177 
200 

201 
202 

203 

204 
205 
206 
207 

210 
211 
212 



SECTOR 
BUFFER 
128(10) UORDS 



ADJUST (D8-DL) 

XTYPE (INPUT PARA) 
-I- 
| XdVTABX 

-I- 
XINDEXP (FINAL 
INDEX PRT) 



10 

I. 



127 
128 
129 
130 
131 



XANAflE (DB REL ADDR) 132 
133 
134 
135 



XGUNAItE (OB REL ADDR) 

XFNRflE (OB REL RDOR) 

XASEC (RCCOUNT 
SECURITY) 



XGSEC (GROUP 
SECURITY) 

SIRRETURN (FR0I1 
GETSIR) 



C. 



213-240^ 

I- 
241 -26r 

I- 
267 

270 
271 
272 

273 
274 



DIRECTORY POINTER 
"A" 



DIRECTORY POINTER 

up. 



Directory Data Sequent (Cont.) 



189 
190 
191 
192 
193 
194 
195 
196 
197 



136 
137 
138 

139-160 \ 
\ 
-I > Sec Directory 

"161-182 / Pointer Rrea 




198 

GQ0DPERCENT«.8S 
199 

200 

201 

"D0S8USIZE 

I 
I 



SYS. ACCT. INDEX 
BLOCK SIZE 

LDEV | PV 
1 

DIRECTORY RDDRESS 



1183 

I 
-I 

|184 
-I 

M85 

PRIVATE VOLUHE I 186 
DIRECTORY SIZE I 
I 
1187 



1188 
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| UORK RREA 

(SIZE OF 
LARGEST 

| ENTRY) 

I- 






•RAX 



11451 



DB AREA 



1613 
'DDSBUSIZE 
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pjrtctorv Pointer Area fDA or DB1 PST*X24 SIR«8 

111111 
0123456789012345 
l-H-l-H-H-l-l-H-l-H-l- 
| LDEV I DIRECTORY BASE | 139/1 61 PIRBASE1' 

| 1 

ADDRESS Of PAGE IN BUFFER 140/162 DIR8ASE2' 



Ol 



DIRECTORY PAGE IN BUFFER 1141/163 CONTENTS 



DB ADDRESS OF 1ST ELEflENT 142/164 LPNTR 



STARTING RODRESS OF BUFFER 143/165 IOPNTR 



« VALID PAGES IN BUFFER 



144/166 NUnVAUD 



IB 145/167 D « DIRTY FLAG, 



ELEHENT SIZE 



-I- 



• UORDS USED IN BLOCK 
"BLOW SIZE (SECTORS) 
BLOCK SIZE (UORDS) 



flAX • ELEHENTS/BLOCK 

l-l-l-l-l 1 

I|P| TY IELEHENT SIZE |BL SIZE 
| | | (UORDS) l(SECTt) 
l-l-l-l-l 1- 

NUHBER OF ELENENTS 



NUflBER OF ACCESSORS 



ENTRY TOTAL 
l-l-l-l-l 

0|P| TV | ENTRY SIZE 
I I I (UORDS) 
-l-l-l-l-l 



B * BRD ELEHENT 
146/168 XSIZE 

147/169 USED 

148/170 BSIZE 

149/171 BUSIZE 

150/172 BFACTOR 

151/173 AISCUD 

152/174 XCOUNT 
153/175 PCOUNT 



FATHER INDEX POINTER 



154/176 ETOTAL 

|BL SIZE j 155/1 77 EMSCUD 
I (SECTt) | 
-I 1 



FATHER 
NAIfE 



I 

I 

I 

-I- 

I 

-I- 

I 

-I— ■ 

' Indexes Only 

: Indsxes and Entritt 



FATHER 



1156/178 PINDEXP 
-I 



1157/179 



-I 

1158/180 PNAHE 
-I 

1159/181 
-I 

1160/182 



1 
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TY « O-FILE 

1 -GROUP 

2-ACCT 

3-USER 

4-VSD 
I « O-ENTRY BLOCK 

1-INDEX BLOCK 
P s PURGE FLAG 



Dirtctory 



Dirtetorv Snact Pat* Sea nent (DIRSOS) 



DST*21 (125) 
SIR-8 (210) 

111111 

0123456789012345 

l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l 
0| LOGICAL DEV | BIT HAP I 

I 1 I 

11 BASE SECTOR ADDRESS IDS' BASE 

| 1 

2| POINTER TO LAST UORD IDS' LAST 'UORD 

| IN BUFFER I 

| 1 

31 POINTER TO FIRST UORD IDS' FIRST' UORD 

| IN BUFFER | 

| 1 

4| SIZE OF DIRECTORY IDS'DIR'SIZE 

| IN SECTORS I 



s*^^\ 



DISC ADDRESS OF CURRENT | 

PART OF BIT I1RP IDS'AODR 
IN THE BUFFER I 



|.|-|-l-h 
5I0IEISIPI 
l-l-l-l-l 

61 FIRST CURRENT SECTOR 
| IN BUFFER 
I- 

71: 

10 
11 
12 
13 
14 
15 
16 



IDS'FLAGS 

1 

IDS'CUR'SECTOR 
I 
•I 



SIZE OF BUFFER IN UORDS I OS 'SIZE 
1 

NEXT REQUESTED SECTOR IDS'REQ' SECTOR 



-I 



LAST SECTOR IN BIT I1RP IDS' LAST 'SECTOR 



-I 



SYSTEfl SAVED PTR TO LAST IDS 'SYS 'LAST 

SYSTEn SAVED PTR TO FIRST IDS'SYS'FIRST 
1 

SYSTEN SAVED CURRENT IDS'SYS'CUR 
SECTOR I 

SAVED DIRECTORY SIZE IDS' SYS' SIZE 
1 

LDEV THAT LAST ERROR IDS 'ERROR 'LDEV 
OCCURRED I 
1 
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Dirtctory Space Data Saonent fDIRSDS) (Cont.) 



-I 



21 1 TYPE OF ERROR THAT 

I OCCURRED I 

| THIS SECTION OF THE BIT NAP | 

I DST IS OCCUPIED BY UP TO 3 I 

I SECTORS OF BIT NAP. IT IS I 

I SURPPED IN 3 SECTORS AT A | 

| TINE AS NEEDEO. OS' FIRST UORD I 



IDS'ERROR'TYPE 



IS UPOATEO TO SEARCH FOR 
SPACE IN THE BIT HAP. UHEN 
IT REACHES OS' LAST' UORD FOR 
THE SECOND PASS, THE NEXT 3 
SECTORS OF BIT HAP UILL BE 
SURPPED IN. 



Partial definitions: 

OS' LDEV > DS'BfiSE0.(C:8) 
OS' DIRTY » DS' FLAGS. (0:1) 
OS' ERR' IN' PROG » OS' FLAGS. (1:1) 
DS'DIR' DISABLED * OS'FLPGS. (2:1) 
DS' PERN' DISABLE * OS' FLAGS. (3:1) 

Descriptions: 

DS'ADDR 

This it the address of tha section of bit nap that it currently in tht 
buffers. For exanple. this address uill usually be tha sane as OS' BASE. If 
ue need to page in nort sectors of bit nap than the first three, then this 
address uill be subsequently larger than DS'BASE. 

DS'BASE 

This is the base address of the directory bit nap. If the dirtctory is 
grtatar than 6112 sectors, then this address uill be 29 sectors less than the 
address found in the Cold Load Information table on disc. 

OS' CUR' SECTOR 

This is the eurrtnt bit nap sector nunber of the first sector in the buffer 
area. Its value can range f ron 1 to 30. This nunber ninus one added to 
OS 'BASE uill result in DS'ADW. 
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Dirtctory 



DS'DIR' DISABLED 

If this bit is on, the directory allocation and deallocation is off and only 
a UARHSTART uill turn this bit off. The bit is turned on if an I/O error 
occurs on a dirtctory bit nap sector or if ue find data integrity problens 
uith the bit nap, i.e., if ue attenpt to deallocate a sector that is alrtady 
deallocated. 

DS'DIR' SIZE 

This is the size (sectors) of tht dirtctory arta. This size includes only 
the last 3 sectors of the bit nap. If the dirtctory is greater than 6112 
sectors, then this size dots not include the extra 29 sectors of bit nap. It 

can also be thought of as tht nunbtr of bits in the bit nap. 

DS' DIRTY 

This bit is set if tht bit nap sectors in tha buffer have been nodifitd in 
any uay. Uhen nort sectors mist be brought into tht buffers, or if ue suitch 
to a different donain (systen to PV, PV to systen) this bit is interrogated 
to deternine if tht sectors presently in the buffers nust be first uritten to 
disc. 

DS' ERROR* LDEV 

The LDEV in uhich tht last dirtctory error occurred. 

DS' ERROR' TYPE 

This uord dtscribts tht typt of dirtctory bit nap error that oceurrtd. Its 
legal values art: 

- No error 

1 - I/O error on a urite 

2 - I/O error on a read 

3 - Attenptina to deallocate space 

that is already deallocated 

4 - Dirtctory spact nanagentnt 

is already disabled 

DS' ERR' IN' PROGRESS 

A dirtctory space nanagentnt error ie currently in progress. 

DS'FIRST'UORD 

A DST relative pointer to the uord in the bit nap buffer that ue uill 
interrogate next uhen dirtctory epace is needed. Uhen the systen first cones 
up, this uord is aluays initialized to 0S'HEADER*2 (i.e., to point to tht 
first uord in tht bit nap). On subsequent bit nap eector reads, it is stt to 
DS' HEADER sines subsequent sectors uill not have the 2 uord overhead that 
exists in the first sector of tht bit nap. 
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Directory 

DS'FLAGS 

This uord contains nunerous flags. Set individual descriptions. 

DS'LAST'SECTOR 

This is tht total nunbtr of active bit nap sectors. This nunber uill range 
fron 1 to 32. 

OS 'LAST 'UORD 

Thit is the current nunber of bit nap uord in the buffer. It can range fron 
1 to Z577 ♦ OS' HEADER. If there exists 3 full sectore in the buffer, then 
it uill have the value Z600 ♦ OS'HEROER - 1 or X621. It is conpared to 
OS'FIRST'UORO to detemine if ue have hit the end of the current buffer area. 

OS' PERH' DISABLE 

If this bit is set, then directory allocation/deallocating is pernanently 
disabled. This bit should not be set. 

DS'REQ' SECTOR 

This is the next sector to begin reading in up to 3 bit nap sectors. It is 
updated by 2 or 3 and the read procedure uill bring in up to 3 sectore 
starting fron this sector. If this tector is set to be greater than 
DS* LAST 'SECTOR, then it is reset to 1. After the sectors are read in, 
DS'CUR'SECTOR is set the DS'REQ' SECTOR. 

OS' SIZE 

This is the size in uords of the bit nap buffer area. It is aluays a 
nultiple of a sector (128 uords). It uill usually have the value of Z800. 
Legal values arc Z200, Z400, and Z600. 

DS'SYS'LAST, DS'SYS'FIRST, DS'SYS'CUR, & OS' SYS* SIZE 

The values of DS'LAST'UORO, DS* FIRST 'UORD, DS'CUR'SECTOR, and OS' SIZE uill 
be stored in these locations uhen the directory space nanagencnt suitches 
fron the systen directory to a private volune directory. And, of course, 
uhen DSfl suitches back to systen donain, the above nentioned values are 
reinitialized uith these values. 



Directory 



Directory Structure 

INDEX BLOCK 
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Directory Definitions 




The Index Block prefix points back to 
the previous higher level. The Index 
Block entries point to the entry blocks. 
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>PAG€ - snallest allocatable record (-phys.recd-J-currently tector. 
>BLOCK - integral* of pages; contains contiguous indicee or entries. 
>INDEX - pointer to entry block, containing nana of 1st entry. 
>EMTRY - infornation-containing "object" n*y contain pointer to an 

index block. 
POINTER - 15-bit positive relative page nunber (relative to directory 

base). 
>DDS - directory data segnent. 
>ELEflENT - a generic nana for index or entry. 



Indm Block Prefix (10 Uords) 



O-FILE \ 

1 -GROUP | 3 BITS 

2-ACCT |< \ 

3-USER I i 

4-VSET / | 

PURGE FLRG< — \ I 
I I 



->| INDEX SIZE (UORDS) 
I 7 BITS 



>| BLOCK SIZE (SECTORS) 
I 4 BITS 



I /-- 

i I 

II 1111111 

0123456789012345 

MSCUD Oil |P|~TY | XSIZE I BSIZE JO INDEX BLOCK INFO. 
H .| , 1 

1 1 XCOUMT 

2 | 1PC0UNT 

3 1 ETOTAL 
, . | . | 1 1 

EMSCUD 4|0|P| TY | iYtlll |E?SIZE 

l-H— | j 

5 1 PlnDEXP 
I 

61 
I- 

PNAhE - > NAHE OF FATHER 



KUflBER OF INDEX POINTERS 

2 NUflBER OF ACCESSORY 

3 ENTRY TOTALS 

4 ENTRY BLOCK INFO. 

5 INDEX POINTER OF FATHER 

6 \ 

I 

7 I 



IEISTNAnE 



Index Entry (6 Uords) 



-I 
|0 1st NAnE OF ENTRY BLQCK 

I 
11 



IEPNTR 
IECOUHT 



POINTER TO ENTRY BLOCK 
NUItBER OF ENTRIES IN BLOCK 



18 I 
I 

19 / 



*The count is incretttntei by each access that uses and relies 
upon a pointer to the Index block, i.e., it is guaranteed not 
to be purged uhilp the count is not * 0. 
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1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

I 

151 



ANARE 

AGIPNTR 
AUIPNTR 

ACAP 
ALATTR 

APASS 



Account Entry (Z36 Uords) 





1 ACCT.NAItE 

2 

3 

4 ACCT. GROUP INDEX POINTER 

5 ACCT. USER INDEX POINTER 
6 



CAPABILITY 






7 

8 

LOCAL ATTRIBUTES 
9 

10 PASSUORD 

11 

12 

13 
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Recount Entry (Cent.) 

OISC FILE SPACE COUNT (SECTORS) 
DISC FILE SPACE LIBIT (SECTORS) 
CPU TIRE COUNT (SECONDS) 
CPU TIRE UMT (SECONDS) 
CONNECT TIRE COUNT (MNUTES) 
CONNECT TIRE UMT (MNUTES) 



■M-M-M-H-l- 
-321 I I I I I I I I I 126 FLAGS (SEE 6EL0U) 

H-l-H-l-H-H-l 
33|S|A|E|U| 127 RAX.JQB PRIORITY 

H-l-M-M-H-H 
34| COItn FILE REC 128 CORRAND FILE LOCATION OF 
! ft RCCT | RCCOUNT UDCS 

| 1 

351 COM FILE REC 1 29 CORRRND FILE LOCATION OF 




HRRO CODED 
1 

I 



I 



| « SYS I SYSTEfl UDCS (SYS RCCT ONLY) I I 

, , , , 

l-l-l-l-l — l-l — l-l — l-l— l-l— l~l— l-l 

I P| I I Rl Rl Al A| U| U| L| LI X| X| SI S| 

\->ASECU| | | |ANY|AC|ANY|AC|ANY|AC|ANY|RC|ANY|AC|RNY|AC| 

I-H-H-H-H--H-H--H-H---IH---I--I-HH— M 
.... 

I 
FILE SECURITY 

P PURGE flag 

S If 1, tytttn ltvtl UDCs txitt (only in "SYS" account) 

A If 1, account ltvtl UDCt txitt for account 

E Account Pattuord Encrypttd 

U Account Pattuord Rt qui red 
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Directory 



Grouo Entry (151 Uordt) 



I 

0| 

I 
11 



21 
3 
4 
5 
6 

7 " 
10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 



GNRRE 



Directory 



Group Entry (Cont.) 



27| 
I- 
301 



-I 



GCAPP8IUTY |23 GROUP CAPABILITY 



GUNKAGE 

31 1 GVSDIPNTR 
| 

32 1 GHVSNARE 



—I 



331 

I- 
34| 



351 



GHVSANARE 



I— ■ 



361 

I- 
37| 



|- GKVSGNAnE 



124 GROUP DIR. BASE LINKAGE 

125 GROUP VOL SET DEFN INOX 
26 KORE VOL SET NARE 

27 

28 (Dtfinition't acet nana) 
29 
30 
131 



401 

I- 
411 

I — 
421 

I- 
431 



I- GHVSVSNAnE 
41 



I- 
451 
I — 



461 GSAVEFIPNTR 

47 | GflOUNTREFCNTR 
| 

501 

I 



(Oafinition'a group nana) 
32 

33 

34 

35 

36 
37 
3? SAVE CELL FOR GF1PNTR 

39 GROUP BIND COUNTER 

40 GSPARE 



GFIPNTR 



GPRSS 



GOFSCOUNT 



GDFSUMT 




GCONTIFIECOUNT 



GCONTIREURIT | 



|0 GROUP NRRE 
1 

12 
3 

4 GROUP FILE INDEX POINTER 
5 

6 PRSSUORD 
7 

is 

|9 DISC FILE SPACE COUNT (SECTORS) 

10 
111 DISC FILE SPACE UMT (SECTORS) 

12 

13 CPU TIRE COUNT (SECONDS) 

14 

15 CPU T»E UMT (SECONDS) 

16 

17 CONNECT TIRE COUNT (MNUTES) 

18 
119 CONNECT TIRE URIT (RINUTES) 



>-> 



■I — 



I20 



25 P| 






-I GSEC 



P * PURGE FLAG 



121 GROUP SECURITY (SEE BELOU) 
I 

1 22 



—I 
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Grouo Entry (Cont. ) 



GUNKAGE 



I P 
2S| 

17 

26IGL 
I— 



(0:1) • 0; HVS it in Sytttn Donain 

(0: 1 ) « 1 ; NVS it in Privatt Volunt Donain 

(8:8) • 0; If not PV or Not Bound 

(8:8) <>0; If PV and Bound 

GROUP SECURITY RASK 
,|-.|— l—l—l—l—l— |— |— 1—|— |— |— |— |— I 
|G|R|R|R|R|R|A|A|A|A|A|U|U|H|U| 
I IANYIAC |AL |GU |GL |RNY|AC |AL IGU |GL |ANY|AC |AL |GU I 
.|_|_|_|_|_|— | — 1~ | — | — | — | — j — j — | — j 
I L I L I L I L | L I X | X | X | X | X | S I S I S | S I S | 
IANYIAC |AL IGU |GL I ANY | AC |AL |GU |GL |ANY|AC (AL |GU IGL I 
-I — | — I — I — I — I — I — I — I — I — I — I — l — I — ■ — I 



G - Group Pattuord Encrypttd 



Filt Entry (Fill Pointer - 6 Uordt) 



(Dtfinition't vol ttt nana) 



I— I- 
IFV I 
I— I- 



2 3 4 



GUWAGE 
7 8 9 10 11 12 13 14 15 



RV1RBX 
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j FNARE 

H 

IBI 

l-l 

I 

I r 

I FVTABINX 



10 FILE NARE 

I 

M 



VOL TABLE INDX / TILE LRbEL 
i/ISC ADDRESS 



I FLABELROOft I 5 

B - Bad filt labtl 
(0:1) » - not dtftctivt 
■ 1 - dtftctivt 



** 
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J I M r gntrv (19 Uords) 



0123456789012345 



I 
01 
1| 
21 
31 

I- 
41 
I 
51 

I- 
61 
I 
71 

I- 
101 
111 
121 
131 

I- 
141 
151 
161 
171 
I- 



l-l-l-l-l-l-l-l-l-l-l-l-l-l-IH 



USER NAHE 



UNAHE 



UCAP 



ULATTR 



UPASS 



|8 PASSUORD 
19 

10 

11 



CAPABILITY 



LOCAL ATTRIBUTES 



Directory 



\}*»r Rttfip ytii/Capabilmes 



FILE-ACCESS ATTRIBUTES^/" SAVE FILES -------\ 

\_N0N-SHRRR8LE DEVICES-«\ I 

'connuMCATiONS \ I I 

NODE ftANAGER \ I I I 



UMGROUP 



JOBPRI 



20 | ULOGCOUNT 

M-l-l-l-l-l — I 
UHAXJOBU 21|P|U|E|R|X|U| | 

M-H-I-H--I 

22 1 COnn FILE REC 3 
| (COnnRND FILE LOC OF 
| USER UDC'S) 
, 



12 HOHE GROUP (HAY BE BLANKS) 
13 

14 _ 

15 / LOG CNT (41 OF USERS 
! LOGGED ON). INIT TO 1 

|16< FOR nAHAGER.SYS SO THIS 
i \ USER CANNOT BE PURGED. 
17 HAX. JOB PRI 

18 



P « PURGE FLAG 

U * UDC EXIST FLAG 

E * USER PASSUORD ENCRYPTED 

R * USER PASSUORD REQUIRED 

X * USER PASSUORD EXPIRED 

U « USER PASSUORD URRNED FOR EXPIRED 



I 

I 
I 
I 
I 
I 
USER / 
ATTR < 
\ 
I 
I 
I 
I 



/- — 
i /- 



NETUORK ADniNISTRATOR- — \ I I I I 



I I I I I 
I I I I I 
I I I I I 
I I I I I 
I I I I I 
I I I I I 
I I I I I 

I I I I I 

| | | | | | I USER LOGGING I I I I 
I I I I I | | I SYSTEfl PROCESS HANDLING 
I I | | | | | | | PROGRRnnATIC SESSIONS 
I I I I I I I I I I I Mil 
|L|--I~I--I~I~I~I~M-MH~M»I 

Sn|An|AL|GUDI|OP|CV|UV|LG|SP|PS|HA|NMCS|NDISF| 
-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l 



-SYSTEn n&R 
-account nw 

•ACCOUNT LIBRN 

j | / GROUP UBRN 

| | | /-—DIAGNOSTICIAN 
| | | | /-SYSTEH SUPVSR 
| | | | | CREATE VOLS 
I I I I I I USE VOLS 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

| | | | | | I iBAIIRIPnl | IRRI IDSIPHI 
_---,--,--|~|~|"|"|"|--l"l~l"IH"l--l 



I 
ACCESS | 
TO < 
GENERAL I 
RESOURCES I 



III I II 

BATCH ACCESS -/ I I I II 

INTERACTIVE ACCESS — -/ I III 

PRIVILEGED nODE / I I I 

I I I 

nULTIPLE RINS - — / I I 

EXTRA DATA SE&HENT / I 

PROCESS HANDLING / 
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SIR Table Info mat ion 

The eysten internal resource table it located in non-linked nenory (resident 
table). The SIR table it utcd to protect critical systen elenents against 
accett by nore than one process, i.e., it provides a "lock out" nechanisn. 
Each critical tytten resource (usually a table) is assigned a specific SIR 
nunber. Procedures are provided uithin HPE to lock (GETSIR) and unlock 
(RELSIR) the SIR. Processes attesting to obtain a SIR that is not available 
are inpeded by the system The SIR table entries font the head of a linked 
list in this case. If nore than one procees becones inpeded, uord 17/18 of 
the PCB entry ie used to add the "neu" process to the growing list. The 
nethod of uninpcding the process depends on the SIR type. 

A SIR does not respect process priority and operates in a FIFO nanner. Uhen 
a process it added to the end of the queue, the priority of the holder of the 
SIR and the priority of all intervening processes are increased. They »rt 
increased to the priority of the neuly requesting process. 

To get SIRs, arrange the SIRt in ascending order by rank. To release SIRt 
arrange the SIRt in dctcending order by rank. For exanple: 



Get SIRt 

GETSIR (LOT) **Rank«85»* 

GETSIR (ODD) **Rank«92** 



Releate SIRt 

RELSIR (ODD) **Rank«92** 
RELSIR (LDT) "Rank«85** 
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RANK 


SISI 


$IR NRHE 


5 


16 


FRRVT 


10 


1 


LORD PROCESS 


22 


17 


LOADER SEGflENT TABLE 


25 


37 


FILE INTEGRITY 


27 


15 


JHAT 


50 


5 


PROCESS TREE STRUCTURE 


60 


6 


SCHEDULING QUEUE 


70 


7 


CST ENTRIES 


80 


8 


SYSTEF1 DIRECTORY 


83 


27 


PV hVTRB 


85 


10 


LDT 


87 


40 


DEVICE CLASS TRBLE 


90 


9 


LPDT 


91 


3 


IDO 


92 


4 


ODD 


110 


11 


STORAGE IN OVERLAY AREA 


130 


13 


JPCNT 


140 


14 


JCUT 


180 


18 


VDD 


190 


19 


SPOOK 


200 


20 


nESSAGE CATALOG 


210 


21 


RIT 


220 


22 


VOLUHE TRBLE 


230 


23 


UELCOHE HESSAGE 


240 


24 


ASSOCIATION TABLE 


250 


25 


CS ALLOCATE 


260 


26 


LOGGING BUFFER 


280 


28 


HEASSIR 


290 


29 


PV USER TRBLE 


300 


30 


IHRGE 


310 


31 


KSAH 


320 


32 


USER LOGGING 


330 


33 


DEBUG BREAKPOINT TABLE 


335 


2 


CRCHE CONTROL 


340 


34 


PCB 


350 


35 


SUB-QUEUE HAPPING TRBLE 


360 


36 


CILOG 


380 


38 


RIN 


390 


39 


TRPE LABELS 


400 


41 


Reserved 



G. 23.00 
5- 2 



Lock Resources 



S]tR Sn^ry Fornatf 
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(not locked) 
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SIR locked 
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TAIL OF IHPEDED LIST (PCB RELATIVE) 



P * PIN R 

PIN * PCB table entry nunber 

SIR QUEUE LENGTH - nunber of processes queued for this SIR 

The SIR table it indexed by SIM. uith each SIRt corresponding to a unique, 
preassigned systen internal resource. Entry RO is not used. Inpeded lists 
are established by using ths SIR table entry (2) as the head of the list and 
PCB(15) for elenents. PINs are aluayt uted at pointers, uith indicating 
end of list. 
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Allocation and Locking of Filt RINS 
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Allocation and Locking of Global RINS 



I 



OST 226 
RIN TABLE 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

.|~IH--I~I--I~I~I~I--IH~I~IH~I~I 
INDEX OF FIRST FREE ENTRY ! 



r 

i 

V 

PCB ft 

b«iting 
procesat* 



(NUHBER OF LOCRL ♦ GLOBAL RINS) * 3 



10 | 



INDEX OF PASSUORO, USERNAItf 



PIN Of HOLDER 



HEAD Of UAITING LIST (P) 



PCB • 



procttt | 

that I 
-holdt" I 



RIN 



RIN PASSUORO 



USERNAnt 

(USER NRHE RNO RCCOUNT) 



| 



INDEX OF PfiSSUORD » RELATIVE TO BASE Of SECONDARY 
TABLE 



G.23.00 
5- 8 



<"**%. 



File Systen 






CHAPTER 6 FILE SVSTEH 
Fill Svsten Overview 



Thi» chapter describes the M»E V file systen, including the beeic concepts 
end the table structures used. 

I/O to files is done by reference to file nunbers, uhich are assigned by 
calling the FCPEM intrinsic. This establishes an initial "point of 
attachnent", uhich nay be described as a connection between a progran (i.e., 
process) and that particular point in a particular file at uhich the next 
FREAD or FURITE uould cause data to be transferred, fl point of attachnent is 
described by a control block, of uhich there art several different kinds 
(described later in this chapter). Control blocks nay exist in the process's 
oun stack or in an extra data segnent assigned by the file systen. In order 
to find control blocks quickly, a pointer schene called vectors is used, fl 
control block is uniquely described by a vector, uhich consists of tuo uords 
uith the first uord containing a segnent nunber and the second uord 
containing a uord offset into the control table of the vector table entry 
uhich describes the location of the control block uithin that segnent. The 
entire aesenblage, consisting of eight overhead uords, the vector table, and 
all of the control blocks to uhich it points, conprises the entire segnent; 
if in a stack, it occupies part of the PXFILE part of the PCBX. 

The point of attachnent is described by a "physical access control block", or 
PRCB, uhich uill exist as a result of an FOPEN to any file (except SNULL). 
Rny required I/O buffers *n associated uith the PRCB. 

All FOPEMs specifying "nulti-access" for all processes running under a single 
job use a single PRCB for references to a nulti-access file. Although all 
these »rt attached to a single point in the file, the type of attachnent 
(i.e., ROPTIONS) nay be different. Therefore, each FOPEN specifying a 
nulti-access file establishes a "logical access control block", or LRCB, 
uhich contains the point-of -attachnent local values. The use of a single 
buffer (i.e., PRCB) ensures that references by various processes or against 
various FOPEMs uithin one process are dealt uith in strict sequential order. 
Note that references to a file by other jobs, or by other processes not 
specifying nulti-access, uill be through other PRCBs, uhose buffers uill be 
read or uritten at the pleasure of the file systen; in order to ensure any 
sort of coherence to such shared references, the jobs nust use global RINS 
and FLOCK and FUNIOCK the file. fSTDIN, fSTDQST, and spoolfiles *rt opened 
nulti-access autonatically. 

In the case of disc files, there is another kind of control block: the file 
control block (FCB). It contains copies of infomation read fron the file 
label, such as the end-of-file pointer, the extent nap, and the record and 
block structure. The EOF pointer is updated in the FCB as the file is 
uritten, and all changes nade to the FCB »rt posted to the file label uhtn 
the file is closed, fln FCB is shared by all jobs in the systen uhich 
reference the file. 
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Table Fomats 



Belou is a detailed discussion of the nain tables constructed and used by the 
file systen. The location and overall structure of each table is given, in 
addition to the table fomat and a discussion of each field in the table. 
Table indices at the right of the table are in octal. Index nanes apply to 
the entire uord; if in parentheses, the nanes are defined in the file systen 
listing but not explicitly used there. 



File Svsten Section of PCBX (PXFILE) 

The PXFILE area is a subsection of the PCBX. It is a contiguous, expandable 
and contractible block of storage that is nanaged by the file systen 
prinarily for its oun use. Other subsystens, nanely CS and OS, aleo nake use 
of the PXFILE section. In doing so they nust conforn to the conventions of 
the file systen. 



The overall structure of the PXFILE area is: 



OVERHEAD 


(FIXED) 


CONTPOL BLOCK 
TABLE 


(VARIABLE) 


AVAILABLE 


(VARIABLE) 


ACTIVE FILE 
1A6LE 


(VARIABLE) 

!DL-5 
I 
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The file nunber assigned by an FOPEN is an index into the Available File 
Table (AFT), a table of six-uord entries uhich is at the end of the PXFILE 
part of the PCBX. Tuo double uords *rt vectors to the PACB and (if it 
exists) the LACB. 

AFT entries can also reside in a global AFT extra data segnent. If the file 
uas opened Global AFT (specified in the AQPTIQNS) and the progran le 
privileged, then the AFT is placed into this global AFT DST. Any accesses to 
the file are identical to local AFTs. All accesses to the file opened global 
nust be done fron privilege node code. The file systen mtrmsics 
distinguish this file by a negative file nunber. Again, these files *n 
identical in every other uay except for uhere the AFT entry resides. 

Because control blocks are shared anong processes, it is necessary to have a 
schene for coordinating access to then. A control block is "locked" by a 
process uhich requires exclusive access to it for a tine. Other processes 
uhich attenpt to lock the block uill find it already locked, and uill be 
inpeded and queued. It nay also be necessary to lock an entire control block 
table so that a process can create or destroy a control block in it, or lock 
or unlock an existing control block in the table. 

Rnother table used by FOPEN is the File fluiti-Access Vector Table (FflAVT). 
This table exists in a systen extra data segnent and is used by all jobs and 
processes in the systen. Uhtn a file is being FOPENed uith nulti-access 
specified, the FflAVT is searched; if the file is already open, the FHAVT 
gives the PACB vector for the prior reference for each job. 



Buffers 



A bit in AOPTIONS specifics, uhen a file is opened, uhether access is to be 

buffered or unbuffered. If unbuffered, data is transferred directly betueen 
the I/O device and the user's buffer (usually in his stack), uhich uill be 
f roien in nenory for the duration of the transfer. If buffered, the data is 
noved betueen the user's buffer and a file eysten buffer to uhich the I/O is 
actually done. 

Buffers *n associated uith the PRCB, attached to it as an appendage. 
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Overhead 



The part labeled Overhead contains infomation that pertains to the entire 
section. It is addressed via the pointer at DL-3. 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
l — I — I — I — I — I — I -l-l-M-MH-M-l B r#w 
0| PXFILE SIZE IN UOROS |0 PfcFSIZE 

| 1 1 

1| LAST DOPEN ERROR NO. | LRSTCOPENERRORNO.il 
2|*N| — " |2 

,..| 

31 LAST DS AFT 3 



SLAVE AFT NUftBER 



-I- 



LAST KOPEN ERROR NO. I 
-I- 



RFT SIZE IN UORDS 



4 

LAST FOPEN ERROR NO. 5 



CS TRACE FILE INFO 

LAST RESPONDING NO-UAIT I/O AFT ENTRY NUftBER 



1ST USER (N08UF) CONTROL BLOCK TABLE DST NO. 
131 2ND USER (NOBUF) CONTROL BLOCK TABLE DST NO. 



14 3RD USER (NOBUF) CONTROL BLOCK TABLE DST NO. 

15 4TH USER (NOBUF) CONTROL BLOCK TABLE DST NO. 

16 5TH USER (NOBUF) CONTROL BLOCK TABLE DST NO. 



PXAFTSIZE 
(PXCTRINFO) 



9 PXFLEFTOFF 

10 PXFCBT1 

11 (PXFCBT2) 

12 (PXFCBT3) 

13 (PXFCBT4) 

14 (PXFCBT5) 



6TH USER (NOBUF) CONTROL BLOCK TABLE DST NO. |15 (PXFCBT6) 



-I 



17 

20 j 7TH USER (NOBUF) CONTROL BLOCK TABLE DST NO. |16 (PXFCB17) 
| 1 

211 8TH USER (NOBUF) CONTROL BLOCK TABLE DST NO. |17 (PXFCBT8) 
| 1 

Partial uord field identifiers »m 

PXFDOPEN ■ PXFILE(1).(0:8)«, last OOPEN error code 

PXFCOPEN • PXFILE(1).(8:8)«, last COPEN error code 

PXFNOCB • PXFILE(2).(0:1)tt, no CBs in PXFILE CBP 

PXFKOPEN > PXFILE(5).(0:8)», last KOPEN error c.de 

PXFFOPEN > PXFILE(5). (8:8)11. last FOPEN error code 
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Oiicuttion: 

PXFRFTSIZE Thit it tht tizt (in uordt) of the Active File Table (AFT). 
The eize it in uordt to tinplify calculating the size of 
the available block. 

PKFCBT1-8 Theee »n the OST nunbere of the uter (N08UF) control block 
tablet, A OST nunber of indicatea that no data eegnent 
it allocated. 

PXFCOPEN Thit containt the latt COPER error nwttr. Not utcd by the 
file tytten. 

PXFCTRINFO Thit containt information pertinent to the CS trace file. 
Not utcd by the file eytten. 

PXFDOPEN Thit containt the latt DOPE* error nunber. Not uted by tht 
file tytten. 

PXFDSINFO Reserved for OS. Not uted by the file tytten. 

PXFFOPEN Thit containt tht latt FOPEN error nunber. If it it zero 
then the laet FOPEN tuccettfully conpleted; otherwise the 
laet FOPEN uat untucceetful and the nunber it the file 
tytten error nunber. 

PXFKOPEN Thit containt tht latt KQPEN error nunber. KSRfl it partly 
enbedded in the file eytten, and an FOPEN failure on a KSRfl 
file can be cauted by a failure to open either the key file 
or the data file. Thit error nunber it uted in conjunction 
uith PXFFOPEN to detemine uhich file caueed the KSRfl open 
failure. Thit error nunber ie not uted by tht fill tytten. 

PXFLEFTOFF Thit it tht RFT entry nunber of the latt filt/lint that 

conpleted a neuait I/O; if zero then no nouait I/O hat been 
conpleted. Thie cell it naintaintd tolcly by and for the 
IOUHIT intrintic. 

PXFNOCB Thit bit signifies that control bloekt are not to be 

created in the PXFILE control block table. Thit bit it ttt 
by the NOCB paraneter to the CRERTE intnneic or the :RUN 
connand. Thie feature pernite the uter to have at nuch 
ttack tpact at pottiblt; otherwise the file eytttn uill 
takt teveral hundred uordt of ttack for the PXFILE control 
block table. 

PXFSIZE Thie it tht tizt (in uordt) of the conplete PXFILE trt: 
It it the tun of the overhead block, the control block 
table, the active file table and the available block. 
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File Syeten 



PXFILE Control Block Table (PXFC8T) 



Addressing uithin a PXFILE control block table it toneuhat nore conplicated 
than addressing an extra data segnent CBT since the table does not begin at 
DB*0. Rs a result all pointer* within the table *rt table relative; the 
starting address of the table nust be added to a pointer to generate a final 
OB-relative address. This addressing convention ie consistently applied to 
all control block tablet. 

Uhen the control block table it txpandtd, tpace it taken fron the RVRILRBLE 
area. If no tpact it available then the PXFILE area ie expanded and the 
acquired epace it added to the RVRILRBLE area. 

RveAMt M9S* 

The part labeled RVRILRBLE it uttd to provide tpact uhen the Control Block 
Table or the Rctive File Table it txpandtd. Thete tuo tables grou towards 
tach othtr, and uhen nore epace ie needed it it tinply taken fron the 
RVRILRBLE Block. 

Uhen the RVRILRBLE area it exhaucted, the PXFILE area it expanded, the RFT it 
relocated and the new tpact it addtd to tht RVRILRBLE Block. 

Currently the PXFILE area it only txpandtd; it it never contracted. 



/*m*\ 
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File Syeten 



Rc^ve. FUf Tab|e (RFT) 



The part labeled Rctive File Table containt infornation uted by the file 
eysten (or CS, OS, etc.) to grossly characterize the file access and, i 
inportantly, to give the location of the control blocks. 

The overall structure of the RFT ie: 






ENTRY N 



ENTRY 1 



I 

I (FIXED, 6 UQROS) 

I 
-I 



I 
-I 

IDL-10 

I (FIXED) 

IDL-S 
-I 



File Syeten 

The structure of a file tytten RFT entry it: 

I 1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 
, |~|_|.-|~|_|H-!H~M~MH--I-I~I 
| | ENTRY TYPE | N| |0 

I | PHYSICAL RC8 OST NURBER |1 RFTPRCBOST ~\ 

I | PHYSICAL RCB ENTRY ROORESS I 2 RFTPRCBENTRY./ VECTOR 

I I LOGICAL RCB OST NUHBER 1 3 RFTLRCBOST ~\ 

j | 1 > LRCB 

I I LOGICAL RCB ENTRY ROORESS |4 RFTLRCBENTRY_/ VECTOR 

1 | NO-lfflIT I/O IOQX 15 RfTIOOX 

Entry format depends on tht entry type; the file tytten utet entry type 0. 
The following partial word field identifiers are uted: 



I 



Uhere N • PXFRFTSIZE / 6. 



The length of the RFT is specified by PXFRFTS1ZE. Unused entries are all 
zeroe. Uhen the table ie full it it txpandtd by taking spact fron the 
Rvailable block. 

The RFT is negatively indexed by file nunber: the entry at OL-10 corresponds 
to file mmber 1, the entry at DL-16 corresponds to file nunber 2, etc. 

The structure of the global RFT OST ie ae follower 

j 1 

| |DB ♦ 

| ENTRY 0, NOT USED I 

I- -I 

| |DB ♦ 6 

| ENTRY 1 I 

|_ .1 



RFTTYPE 
RFTNULL 



Discussion: 
RFTIOOX 



RfT. (0:4)1, 
RFT.(4:1)U, 



tntry type 
8NULL file 



ENTRY N 



I06 ♦ (N * 6) 

I 
I 
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RFTLRCBOST 



RFTLRCBENTRY 



RFTNULL 



RFTPRCBOST 



Thit it tht IOQ index of the pending nouait I/O (if any). 
Thie ie applicable if the file uat opined uith tht NOURIT 
option sptcifitd. Also, CS and DS havt tht sent capability 
and use thit cell in a consistent nanntr. Thit it because 
the lOURIT intrineic services the file eysten ae well as CS 
and DS, and is the principal ueer of thie cell. If the IOQX 
ie negative, then one of tuo pottibilititt exist. If tht 
filt it a ntttegt file, then filt IOOX it tht accessor' s 
reply port. If tht filt it a standard RPE filt, thtn a read 
uat dont to a nontxitttnt extent and this is sinply a stub 
inserted by the file system 

Thie ie the DST that the Logical RCB (LRCB) if it exiete. 
Thie ie applicable if the file uae opened uith the 
nulti-access option specified. 

Thie ie the uord offeet into the control block table of the 
LRCB vector table entry, applicable if the file was opened 
with the nulti-acceee option tptcified. 

Thie bit signifies that tht file ie tNULL and that there are 
no control blocks. 

This is tht DST that containt tht Phytical ACB (PRCB). R 
PACB txittt for all filtt txctpt tNULL 
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RFTPfiCBENTRY 



AFTTYPE 



Fill Sytten 

Thit it the uord offttt into the control block table of the 
PflCB vector table entry. This uill be nonzero for all filet 
except NULL. 



Thit it the RFT entry type nunber. 
entry typet are defined: 



At pretent the following 



- File tytten 

1 - Renote file 

2 - OS (nouait I/O ditalloued) 

3 - OS (nouait I/O allotted) 

4 - CS 

5 - CS (Autodial) 

6 - KSAH 

8 - hettage File 

9 - RFR Port 

13 - Advanced Network Subtytten 



Rmote File AFT Entry 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

— I — I — I — I — I — I — I — I — I — I — I — ■ — ■ — ■ — ■--» 

FSTYPE I UNUSED IHRJO 



-I- 



REflOTE FILE NUHBER 



LINE NUflBER 



-M 
M 
1 

|2 



-I 
PENDING FCLOSE DISPOSITION FR0I1 FOPEN 1 3 

UNUSED l« 



IOQX 



AFT 

FSTYPE - 

flR 
AFT 1 
AFT 2 
AFT 3 

AFT S 



Thit value uill be 1 for renote filet. 

Set if the file uat opened nulti-accett. 

Local line nunber of renote file. 

File nunber of the renote file. 

Pending ditpotition of the file. Set uhen file uat FOPEN' d 

and uill pottibly be uted at the FCLOSE ditpotition. 

No uait I/O Queue Index. 



/pw\ 
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File Sytten 



KSAtl AFT Entry 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
— I — t — • — I — I — I — I — t — I — I — I — I — I — I — I — • 

FSTYPE I UNUSED |0 



-I- 
RFT NUnBER OF KEY FILE 



AFT NUHBER OF DRTA FILE 



KSRn XDS DST (Tagged "KSRir) 

KSAH XDS DST (lf<>0, tagged "RLKSMr) 



IOQX 



-I 



AFT 0. (0:4) - FSTYPE (6) 

AFT 1 - AFT nunber of key file 

AFT 2 - AFT nunber of data file 

AFT 3 - KSAfl XDS DST (Tagged "KSWT) 

AFT 4 - KSAfl XDS DST (If non-zero, the tag uill be "RLKSAII") 

AFT 5 - No uait I/O Queue Index 



r, 



File Sytten 



PS AFT Entry 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

,.Vi--i--ihhhh--i--m--m--m--i 

FSTYPE I CI fl| P| R| OS ERROR NUnBER 

I--I--I--M 

I DATA SEGffENT NUHBER M 

| — | 1 

| DSDCB INDEX I UNUSED 1 2 

| LDEV NUHBER 1 3 

| 1 

I PREVIOUS AFT POINTER 1 4 



IOQX 



AFTO 

FSTYPE - 
C 

n 

P 

R 
AFT 1 
AFT 2 
AFT 3 
AFT 4 
AFT 5 



Thit field uill have the value 2 or 3. 

On if DSOPEN called by CXDSUNE or RENOTE' HELLO. 

On if Hatter PTOP AFT. 

On if PTOP related. 

On if renote nain proeett. 

OS data tcgnent table pointer. 

DSDSCB Index • OS data segnent control block index. 

Logical device nunber. 

Preceding OS open RFT Pointer. 

IOQX - Sane at detcnbed above. 
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AFT for RFA 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
,...| — |- H ..-|~|~I — I — I— I — I — I — I — I— 1~ I— 
0| FTYPE | SUBSYS I SUBTYPE I N | F 

| , 1 1 l—l- 
ll RFA'HASTER* \ LF CBN for RFA 



I- 
21 



-I- 

DSTX FOR RFA XDS BUFFER SPRCE 
-I- 



I- 
31 IPC ID, N/U RFR 



4| PENDING FCLOSE DISPOSITION CODE 
5| IOQX (NOUAIT I/O) 



| REHOTE ENVNUH 
-I- 



AFT 

FTYPE - Thit field uill be 9. Data Conn FTYPE. 

SUBSYS - Thit field uill be 2. ADS application services. 

SUBTYPE - 1 * Renote File Rccett. 

4 * Renote Data Bate Rccett. 
N - = File it regular uaited. 

1 = File I/O it nouait. 
F - * An error/failure occurred. 
1 a No error. Nornal operation. 
AFT 1 

Buffer nunber of RFA Hatter Entry. 
Buffer nunber of Local File Control Block Entry. 
- DST nunber of AFA XDS. 



RFA'HASTER « 

LFCBtt 
AFT 2 
AFT 3 

IPC ID 

ENVNUH 
AFT 4 
AFT 5 



- IPC ID for RFA nouait I/O. 

- Environnent nunber of renote environment. 

- Pending FCLOSE ditpotition code. 

- IOCX - If <> 0, then it it the tytten DB addrett of a 
tingle request IOQ entry. IOUAIT utet thit uord to 
past the IOQ index of the conpleted request for thit 
AFT to CSIOUAIT. 
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Filt Systen 



gS Line gnjry 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
H~|-M-|~M~M«I~IH~I-M~I 
FTYPE I Ul UIIOI Bl UWJSEO |0 

LOGICAL DEVICE NUHBER |1 

VECTOR TO RULTIPLE 100 INDICES 12 

. ,..,.. | . 1 1 

TR I II Rl DIRLI UNUSED |3 
1 .. | .. | 1 1 

MSC'DST |4 
1 

IOQX ( CIO ONLY ) IS 



This value Mill be 4 or 5. R 5 signifies that the lint 

has an autodials r attached. 

Ths lins hat bssn opcnsd uith no waiting on I/O requests. 

Line is a nultipoint control or 3270 station. 

Line uas opened uith buffering. 

Logical dsvics nunbsr of the line. 

Vsctor to Rultipls IOQ indicts. 

Bit on signifies tracing enabled. Bit 1 en signifiss 

tracs all. 

On if line is currently connected. 

Signifies that this CS device is an SCCP deviee. 

« Dial on unte, answer on read. 

1 ■ Rnsuer on urits, dial on read. 

2 * Rluays dial. 

3 « Ntvtr dial. 

DST nunbsr of the line's nisc data ssgnsnt. 
If <> 0, than it is the systsn 08 addrsss of a single request 
IOQ entry. I0URIT usts this uord to pass ths IOQ index of the 
conplsted request for this RFT to CSIOURIT. 



RFTO 
FTYPE 


U 

ID 

B 

RFT 1 

RFT 2 

RFT 3 

TR 


I 
R 
DIRL 


RFT 4 
RFT S 
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Fils Systsn 



File Control Block Tablt (CBTRB) 



R fils control block tabls can bs located in tuo placet: »9 a subpart of the 
PXFILE *m, or in a data ssgnant. Although putting control block tables in 
PXFILE has ths advantage of providing rapid access, it detracts fron the 
space for the user's stack; so the larger control blocks (or optionally, all 
control blocks) are put into antra data segments. On the other hand, 
referencing extra data segnents nay result in an abssnee trap, uhich is slow. 

Thsre are three typei of extra data segnent control blocks; expandable, 
nonexpendable, and shared FCB. Nonexpendable CBTs trt used for a single PRCB 
uith buffers, i.e., uhere the control block is large or uhere the control 
block can't be local to a single process (for nulti-access). Expandable (or 
NOBUF) CBTs are used for snail control blocks ,as LRCBs, PRCBs uith no 
buffers, and FCBs uhich are local to a single process. R list of the 
expandable CBTs associatsd uith a process is kept in the overhead »rt* of 
PXFILE. When a snail control block is needed, these CBTs »rt checked in 
order to see if one of then has roon. Shared FCB CBTs »rt simlar to 
expandable CBTs except that they belong to the systen rather than to a single 
process; the systen keeps a list of DSTs uhich it has assigned for this 
purpose. 

The overall structure of a control block table is: 



,. -.-.^ 






OVERHEAD 



I VECTOR TRBLE 



I 

I (FIXED, 8 UOROS) 
I 
-I 



KVRRIRBLE) 



CONTROL BLOCK 
RRER 



I 

I 
KVRRIRBLE) 

I 
I 
I 
I 
-I 
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File Systen 



Overhead 



The pert labeled Overhead contains infornetion pertaining to the entire 
table. 



1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 
I— I— I— I— I— I— I— I— I— I— I— I— I— I— I— I— I 

I TRBLE SIZE IN UOROS |0 CBTSIZE 

I OST NUHBER CONTAINING TRBLE *~|1 C8T0STX 
I TYPEI VECTOR TABLE SIZE IN UORDS 12 
I I LI ----- CBTCONTROL 

l-l-l 1 

| LOCK PCBPTR (PCB'KUfl * PCB'SIZE) |4 CBTPIN 

I WPEDEO QUEUE HEAD ™|5 (C8TQUEUE) 

f IRPEDED QUEUE TAIL If 

I UNUSED |7 



Other identifiers used: 

CBTTYPE » C8TRB(2).(0:2) 
CBTVTSIZE * CBTRB(2).(2:14) 
CBTLOCKBIT * CBTCONTROL. (1:1) 

Discussion: 

CBTDSTN 



File Systen 

CBTPIN 

CBTSIZE 



CBTVTSIZE 



This ie the PCBPTR of the process that has the control block 
locked (PCBPTR « PIN'NUfl * PCB' ENTRY' SIZE). 

This is the site in uords of the table. It is initialised 
uhen the table is created and changed uhen the table is 
expanded. At present a tabls is nevsr contracted, even 
though this is possible. 

This field is the type of the control block table. Poeeible 
values %t%\ 

- Stack [PXFILE] 

1 - NOBUF (expandable) 

2 - Systen shared FCB 

3 - Buffered (Contains a single PAC8) 

This is ths size, in uords, of the vector table area in the 
control block table. It does not reflect the nunber of 
entriee used or unused. 



NOTE: All PINs ere kept as the uord offset into the PCB table and as the 
actual PIN nunber. 



Control block table type 
Vector tabls size 
Lock bit 



CBTLOCKBIT 



CBTQUEUE 



This is the DST nunber of the data segnent that contains the 
control block table. If the table ie contained in a stack, 
i.e., in the PXFILE area, then this is the DST nunber of the 
stack and not 0. 

If the entire control block table is locked, then this bit 
is sit. No locking count is kept sines control blocks tr% 
locked only once fron FCRERTECB and FDELETECB uhen control 
blocks are a-<ded to and deleted fron ths tabls. The 
f-ocedure LOCK'CB doee not lock the control block because it 
runs PSEUDODISRBLED during the critical tines. 

This is the impeded queue for the table and has ths sane 
fornat as the inpeded queue for a control block in the 
title. There ie no second inpeded queue because that 
facility is usea exclusively for BREAK requests against the 

PfiCB for »$*0!k/tSTDLIST. 
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File System 



Vector Tab^ 



The part labeled Vector Table containe information used to locate and lock or 
unlock control blockt in tht control block tabic. 

The overall structure of the vector table ie: 



ENTRY 



\ 
I 
I 
I 
I 
I 



ENTRY N 



I- 



-I 

| (FIXED, 8 UORDS) 
I 
-I 
I 



I (FIXED) 
I 
-I 



Uherc N » (CBTVTSIZE/8) - 1. 

Rn unused vector table entry uill have zeros in all the uords of the entry. 
R used vector table entry uill have a nonzero value in the first uord of the 
entry (the control block address is necessarily nonzero). 

The general structure of a vector table entry is: 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
M-M-M-I-MH-M~M--M~I 
| CONTROL BLOCK RDDRESS |0 VT'fiDR 

| .. | .. | 1 1 

| LI B| COUNT | UNUSED |1 VT'CONTROL 

| ,-|— | 1 1 _ 

| LOCK PCBPTR 12 VT'PIN \ 

1 I 

| HIGH PRIORITY HERD PCBPTR 13 VT'QHERD I 

| 1 I 

| HIGH PRIORITY TRIL PCBPTR 

| 1 

I LOU PRIORITY HERO PCBPTR 

, 1 

| LOU PRIORITY TRIL PCBPTR 

I UNUSED \1 



>-\ 



l~ 



-I 



|4 VT'QTRIL 

I i 
IS VT'SRVEDHERD I I 

I I 
|6 VT'SflVEDTflIL_/ I 

PCB I 

Relative <--/ 
Pointers 
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File Systen 



Control Block firea 



The part labeled CONTROL BLOCK RRER contains the control blocks used by the 
file systen. 

To facilitate storage nanagenent, all control blocks have the sane overall 
structure: 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

— I — I — I — I — I — I — I — I — I — i — ■ — I — ■ — ■ — ■- ' 

TYPE | SIZE 



CBDESCRIP 
1 



DRTR 



Uhere N • Size-1. 

Partial uord field identifiers arc: 



^K 



CBTYPE 
CBSIZE 

Discussion: 

CBDESCRIP 

CBSIH 

CBTYPE 



CB. (0:2)11, 
CB.(2:14)#; 



control block type nunber. 
control block size 



This is the first uord of a control block; the fornat is 
coroion for all control blocks. 

This is the size (in uords) of the control block. The sis 
includes the descriptor uord. 

This is the type nunber of the control block. There *rt 
four types of control blocks: 



Garbage 
FCB 
PRCB 
LRCB 
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File Systen 

The follouing partial uord identifiers are used: 

VT' LOCK' BIT « VT'CONTROL (0:1) 
VT'BREAK'BIT « VT'CONTROL. (1:1) 
VT'COUNT » VT'CONTROL. (2:6) 

I Discussion: (Note: PIN « PCBPTR in the discussions I PCBPTR 

* PIN'NUH * PCB' ENTRY* SIZE ) 

VT'RDR Control block address is the table relative address of the 
control block associated uith the vector table entry. It is 
a uord displacement fron the beginning of the control block 
table. 

VT'BREflK'BIT This bit signifies that ue are in the middle of break node. 
This is used for the PRCB of ISTDIN/ISTOUST fron a teminal 
session only. 

VT' LOCK' BIT This bit is set uhenever the control block is locked. 

VT'COUNT This is the count of the nunber of tines that the control 
block has been locked by the process identified in VT'PIN. 
If it is zero, then the control block is not locked. 

VT'PIN Contains the PCBPTR of the process uhich has exclusive 

access to the control block. Other processes attenpting to 
access the block uill be inpeded and queued. PCBPTR * 
(PCB'NUfl * PCB* ENTRY' SIZE) 

VT* QUEUE The high priority inpeded queue is a double uord of PINs 

that are the head and tail of the inpeded queue of processes 
uaiting for access to the control block. Processes ere 
inpeded and uninpeded by the file systen ueing the norasl 
nechamsns available under RPE. 

VT'SRVEDOUEUE The lou priority inpeded queue is a double uord of PINe and 
has the sane fornat as VT' QUEUE. The only tine this uord is 
used is uhen the control block is in BREAK node, which can 
only happen to an RCB corresponding to SSTDIN/tSTDLIST. 
It is used to save the current VT' QUEUE uhen the control 
block goes into BRERK node and to restore VT' QUEUE uhen the 
control block goes back into ncn-BRERK node. 

NOTE: Rll PINs »rt stored ao offeets uithin the PCB table and not as actual 
PIN nunbers. 
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File Syeten 



Uhen a control block table is created the initial control block area is 
completely allocated to a single control block of type garbage. Uhen space 
is requested for a neu control block the control block area is scanned (using 
a first fit algonthn) for a garbage control block that is as large as the 
size requested. The space for the neu control bloek ie taken fron this 
garbage control block and the space renaming becones the neu garbage control 
block size. 

Uhen space ie returned it becones a neu garbage control block. To reduce 
f ragnentation the neu garbage control block is conbmed uith either of the 
tuo neighboring control blocks if they are of type garbage. 

If space is requested and no garbage control block is large enough to eontain 
the neu control block then the control block area and control block table are 
expanded by a sufficient anount. If expansion is not possible, sons other 
control block table nust be used. 

Recess Control Block (RCB) 

Virtually every file systen intrinsic constructs an RCB as its first action. 
Uhen using the nulti-access option, each accessor shares a single PRCB. 
Houever each accessor is permitted to vieu the ehared file in a slightly 
different nanner than the other accessor*. For example, one accessor nay 
access the file in a read-only node uhiie the other acceesore may access tht 
file in a read-urite node. To do thie, each accessor mist, during his 
access, have a slightly different RCB. 

The PRCB holds information that is global to all accessort of the file. Tht 
LRCB holds information that is local to each accessor of the file. Rt the 
beginning of a particular access, an RCB is constructed by calling LOC'RCB, 
uhich copies information fron both the LRCB and the PRCB. Rt tht end of tht 
access, the RCB is released by calling UNLOCK' RCB; thie updatee the PRCB and 
LRCB fron the RCB eince eone of the fields may have been modified due to tht 
access. This scheme nearly eliminates EXCKRNGEDB's to access the various 
data segne*ts. 
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Flit Systen 



Logical Rcctn Control B lock (LRCB) 



All LACBs have the sane structure: 



I o 1 2 3 4 5 6 7 I 9 10 11 12 13 14 15 

|-^|— 1—|— |— 1—|— I— I— I— I— I— I— I— I— I— I 

| 0| 3 I COHPLETE 1KB SIZE I 

| 1 1 

| 1 1 FILE UMBER 



| 2 1 FILE KAI1E - 1ST CKRR. 
I 3|" 



FILE KAHE • 3RD CKRR. 



| 4 1 FILE KANE - 5TH CHAR. 



I 
I 

I 7 

I 10 

I 11 

I 12 

I 13 

I 14 

I 15 

I 16 

I 17 



FILE KflnE - 7TH CKRR. 



FILE KRHE - 2ND CKRR. 



FILE HAKE - 4TH CKRR. 



FILE KRHE - 6TH CKRR. 



FILE KRflE - STH CKRR. 



FOPTIOMS 



ROPTIONS 



RECORD SIZE IN BVTES 



BLOCK SIZE IK UORDS 



SPARE 



CRRRIRGE CONTROL CODE 
-|— |— ,—,—!— |— |— I— j— |— j- 



-I- 



-I- 



|EQF|PG ILK 1ST |FK |TC |TB 180 |CRR|DB I EOF T | EOF A I 
— I — I — I — I — I — I — I — I — I — I — I 1 1- 

C | |TE IIC I Q I I TERMHRL STOP CHARACTER 



-I- 



ERRQR CODE 



-I— |— l-H— 1« 



LAST I/O TRAKSniSSIOH LOG 



Partial uord fitld identifiers art: 



LACBSIZE 
LACBSTOPCKAR 



• LACB.(2:14)i, size in words 

• LAC8(2).(0:8)«, terninal step character 
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Phviieal Rccttt Control Block (PACB) 
Tht overall ttrvcturt of tht PACB it: 



I- 



BASICi 



BUFFERING 
EXTENSION 



I- 



(FIXED) 



(VARIABLE) 



Tht buffering txttntion it optional; it it prettnt if and only if tht filt it 
accessed with bufftring. Thtrt art, thtrtfort, two poetiblt fornatt for en 
ACB: 

1. No bufftrt; tht bufftring txttntion it not prttent. 

2. PACB buffert; tht bufftring wttntion it prttent and tht bufftrt 
art in tht bufftring extension. 

If nultiple PACB buffert mitt, thtrt uill bt a buffering^ txtention for taeh, 
imtediately preceding the buffer. The batie PACB (or NOBUF PACB) it copied 
into the the ACB at uordt through X63; an ACB "tjcttntion" it then 
generated in uordt Z64 - Z67. The resulting ACB thut hat the following 
fornat: 
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File Systen 

Discussion: 

LACBAOPTIONS 

LACBBSIZE 

LRCBCTL 

LRCBERROR 

LRCBFKUn 

LACBFOPTIOKS 

LACBKODE 

LRCBKARE1-8 

LACBPACB 

LACBRSIZE 
LACBSIZE 

LACBSTATE 

LACBSTOPCKAR 

LACBTLOG 



See RCBROPTIOHS. 

See ACBBSIZE. 

See ACBCTL. 

Sec ACBERROR. 

Sec RCBFHUK. 

See ACBFOPTIOHS. 

See ACBHOOE. 

See ACBHAHE. 

This is the OST end vector table entry for the 
Physical ACB (PACB) for the file. 

See ACBRSIZE. 

This is the size, in uordt, of the LACB. All LRCBs art 
tighteen (deeinal) uordt long. 

See AC6LSTATE. 

See ACBSTOPCKAR. 

Sec RCBTLOG. 
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Access Control Block (ACB) and Physical Access Control Block (PACB) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

..,—,—,—,—,—,— |— I— |— I— |— I— I— I— |— 

0| 2 | COMPLETE ACB SIZE 



10 



-I- 
FILE HUKBER 



FILE HAKE - 1ST CKRR. 
FILE HRKE - 3RD CKRR. 



FILE KAKE - 5TH CKRR. 



I FILE NRftE - 2ND CKRR. 

| FILE HAKE - 4TH CKRR. 

-I- 



2 
3 



I 



FILE KAKE - 6TH CHAR. 



FILE KRRE - 7TH CKRR. 



FILE NRItE - STH CKRR. 



FOPTIONS 



AOPTIONS 



RECORD SIZE IN BYTES 



BLOCK SIZE IN UOROS 



UNUSED 



CRRRIRGE CONTROL CODE 
...|— |— |— |— |— |— |— |— |— |— | 1 

IEOFIPG ILK 1ST |FK |TC |TB |8B ICRRIDB I EOF T | EOF fl | 



., — ,—, — ,— ,...| — j- 



C I 



-I— I — I- 



-I- 



JTE JIC | I I TERHINRL STOP CHARACTER 
ERROR CODE 



LAST I/O TRRHSfllSSIQN LOG 



RECORD TRANSFER COUNT 



BLOCK TRANSFER COUNT 



16 

17 

20 

21 

22 

23 

24i 

251 

, 

261 

| CURRENT VRRIRBLE BLOCK KUflBER 
271 

301 

| HIGHEST BLOCK NUHBER STRRTED 

311 



FILE POINTER 



10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 



I- 
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>**isx 



/W*fcv 



^*%\ 



File Syattn 



Access Control Blocks ( ACB'il (Cont.) 



j^*\ 



' ■ » .».«..^i l i H l. l !L l l l »,!L l !!.,2. l 



321 

I 

331 



-I — I — I — f- 

FCB VECTOR 



126 

I 

127 






34| 



TOTAL NUHBER OF LACB'S 
" "" DEVICE TYPE 



351 |BK | _ 

361*" LOGICAL OEVICE NUH8ER 
I — I— I ! 



LAST LOGICAL I/O STATUS 



-|- 



-I- 



37JPF JHITI I CURRENT BUFFERI TAPE OISPLACE | NO. BUFFERS 31 

j ... j ... | 1 1 1 1 

40 1 CURRENT RECORD UORD INDEX 32 

^ 



411 



BUFFER SIZE 



42|* VIRTUAL LOGICAL DEVICE NO. 



I- 



431 FHAVT INDEX 

44| NUHBER OF INPUT LACB'S 
, 

451 NAHE TYPE 



File Systsn 



Tht above uords, 0-X63, art physically located in the PACB of the file. 
Btlou, uords Z64-Z67, art used by file systtn wtrinsics, and art placed onto 
the stack by the procedure LOC'ACB uhen locking the "".Therefore, the 
buffering extension, present, uill immediately folio- uord X63 of the acti 
ACB in the Control Block Table of the file. -,.„„„,.,- 
| o 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



i actual 



I— I 



|—|~|— |— I— |— I— I— I — I — I— I— I— I— I 



| 64 | DST RELATIVE OFFSET TO PACB 



65 | DST RELATIVE OFFSET TO LACB 
I 



| 66 | DST RELATIVE OFFSET TO ACB IN THE STACK 



I 67| 



STACK RELATIVE OFFSET TO DB 



I52 
-I 

I53 
-I 

I54 
-I 

1 55 



I- 



Tht following ldtntifiert art used uhen referring to an ACB: 



1 



46 1 



50| 



52 

53 



63! 



ACCESS BIT HAP 
-I— I— I— I— I- 
S I II | Q | R i D I 
■I— I— I— I— I 



■— I- 



FILE DISPOSITION 



-I- 



SPOOLED DEVICE TYPE I SPOOLED DEVICE RECORD SIZE 



|AE |RU IA8RINE I SEOFS I EOFS 1 39 

r!r:i~±::i:::!:~:::i w 



BLOCKING FACTOR 
-I — I — I— !-——!- 



-I- 
SPOOLED DEVICE FOPTIONS 



SPOOLED DEVICE AOPTIONS 



IDO OR ODD INDEX 



NO-UAIT DISC ADDRESS 



UNUSED 



NO-UAIT LOGICAL DEVICE 



55 
56 
57 
60 
61 



621 UNUSED 



P1P2 USED BY FDEVICECONTROL 



41 
42 
43 
44 
45 
46 
47 
48 
49 



UNUSED 



151 



(RCBSIZE) 

ACBFNUn * 

ACBNAHE * 

ACBNAnEI * 

ACBNAHE2 * 

ACBFOPTIONS « 

ACBAOPTIONS * 
ACBRSIZE 
RCBBSIZE 

Spare * 

ACBCTL • 
ACBLSTATE 
AC6E0F 
ACBLPCTL 

ACBPAGECTL * 

ACBUNECTL • 

ACBSTREAH « 

ACBFKEYS = 

ACBXHITCRLF * 

ACBTBLOCK « 

ACBBINARYIO > 

ACBCRRRIRGE • 

(ACBDEF6L0CK) * 

ACBREADCODE » 

ACBRERDTYPE » 

ACBREADHODE « 

ACBHODU ' 
ACBttODE 

ACBCIROVERFLOU* 
ACBSETHODE 

ACBTAPEERROR * 

ACBINHI8CRLF « 
ACBQUIESCE 



ACB. (2:14)11, 
ACB(1)«, 
ACB(2)*, 
ACBDBL(1)*, 
ACBDBU2)*, 
ACB(6)*, 
ACB(7)N, 
ACB(8)*, 
ACB(9)tt, 
ACB(10)«, 
ACB(11)«, 
ACB02)*, 
ACBLSTATE. (1:1)11, 
ACBLSTATE. (2:2)*. 
ACBLSTATE. (2: 1)«, 
ACBLSTATE. (3:1)11, 
ACBLSTATE. (4:1)*, 
ACBLSTATE. (5:1)*, 
ACBLSTATE. (6:1 )*, 
ACBLSTATE. (7:1 )N, 
ACBLSTATE. (8:1 )*, 
ACBLSTATE. (9:1)*, 
ACBLSTATE. (10:1 )», 
ACBLSTATE.(11:4)I, 
ACBLSTATE. (11:2)*, 
ACBLSTATE. (13:2)*; 
ACB(13)*. 
ACBnODU.(0:8)», 

Acanoou. (0:1)», 

ACBHODU. (4:4)11, 
ACBHODU. (4:1)*, 
ACBHODU. (5:1)1, 
ACBHODU. (6:1)1, 



size in uords 

file nunber 

file nane 

file mnt - first half 

file nane - second half 

FOPTIONS 

AOPTIONS 

record size (bytes) 

block size (uords) 

Unused 

carriage control uord 

local state flags 

end of file sensed 

page and line control 

page control 

line control 

atrtan I/O 

restore function keys 

transmit CR,LF to user 

disable block node 

8-bit terminal transfers 

carriage control flag 

default blocking 

input EOF check 

input EOF type 

input EOF nodt 

node uord 

node setting 

signifies CIR overflou 

FSETHODE bits 

report rtcovtrtd tape error 

inhibit terminal CR/LF 

critical output verify 
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ACBSTOPCKAR 


• 


ACBHODU. (8: 8)11, 


ACBERROR 


■ 


ACB(14)*, 


ACBTLOG 


B 


AC805)*, 


ACBFPTR 


8 


ACB0BL(O8)», 


ACB8LK 


8 


ACBOBL(09)*. 


ACBRTFRCT 


S 


BC8D8L(10)», 


ACBBTFRCT 


■ 


AC8DBL(11)*. 


ACBHIBUC 


> 


ACBDBL(12)», 


ACBFCBV 


s 


ACBDBL(13)«, 


AC8SHCNT 


■ 


AC8(28)N, 


ACBSTATU 


* 


ACB(29)*, 


AC6BRERK 


8 


ACBSTATU. (1:1)*, 


ACBDTYPE 


8 


ACBSTATU. (2: 6)*, 


ACBACCCL 


8 


ACBSTATU. (2:3)11, 


AC8SUBCL 


S 


ACBSTATU. (5:3)*, 


ACBSTATUS 


8 


ACBSTATU. (8:8)*, 


ACBQSTATUS 


a 


ACBSTATU. (8: 5)N, 


ACBGSTATUS 


s 


ACBSTATU. (13:3)*, 


ACBDADDR 


* 


AC8(30)«. 


ACBBUFX 


s 


AC6(2D*. 


ACBPRIV 


s 


ACBBUFX. (0:1)*, 


AC8HIT 


a 


ACBBUFX. (1:1 )•, 


ACBCURRBUF 


8 


ACBB : .'FX.(4:4)«, 


ACBNUHBUFS 


8 


ACBBUFX. (12:4)*, 


ACBBUFUSED 


8 


ACB (•>:)*, 


ACBBUFSIZE 


8 


ACB(33)N, 


ACBSPVDEV 


8 


AC8(34)«, 


ACBFnRVTX 


8 


ACB (35)*, 


ACBSHCNTIN 


8 


AC6(36)«, 


ACBDNTD 


8 


ACB(37)», 


ACBONTYPE 


8 


ACBDNTD. (0:8)*, 


ACBDISP 


8 


ACBDNTD. (8:8)*, 


ACBAHLD 


8 


ACB(38)*. 


ACBACCESS 


8 


ACBAHLD. (0:8)11, 


AC88LXFACT 


a 


ACBAHLD. (8:8)*, 


AC8GSTU 


a 


ACB(39)*, 


AC8SP00LED 


a 


ACBGSTU. (0:1)*, 


ACBSPOOUO 


a 


ACBGSTU. (0:2)11, 


ACBSPSO 


a 


ACBGSTU. (2:2)*, 


AC8SPSQZ 


a 


ACBGSTU. (2:1)*, 


ACBSPRSQ 


s 


ACBGSTU. (3:1)*. 


RC8SPDSQ 


8 


ACBGSTU. (4:1)11, 


ACBNOUAITEOF 


8 


ACBGSTU. (8: 1)«, 


AC8N0UAITH0DE « 


ACBGSTU. (9: 1)11, 


ACBABORTREfH 


a 


ACBGSTU. (10:1 )t. 


ACBNEUEOF 


a 


ACBGSTU. (11:1)*. 


ACBSAVEEOFS 


a 


ACBGSTU. (12:2)*, 


AC8E0FS 


a 


ACBGSTU. (14:2)*, 


AC8SPTYRC 


a 


ACB(40)N, 


ACBSPTYPE 


8 


ACBSPTYRC.(0:6)*, 


ACBSPREC 


s 


ACBSPTYP.C.(6:10)« 


ACBSPFOPT 


s 


ACB(41)N, 


ACBSPAOPT 


8 


AC6(42)«, 



terminal stop character 
error code 

last I/O transmission log 
current record nunber 
current variable block 
logical record TFR count 
block transfer count 
highest block started 
FCB Vector table entry 
« of LACBs 

access class, status, etc. 
break (8STDIN/L1ST only) 
device type 
device access class 
device sub-class 
last logical I/O status 
qualifying status part 
general status part 
Ldev nunber of file 
buffer data & nisc. flags 
privileged access only 
buffer hit flag 
current buffer nor. 
nunber of buffers less 1 
used block uord count 
buffer size (uords) 
spooled virtual device 
FHAVT index 
nunber of input LACBs 
type & disposition 
nane type for dir. search 
file disposition 
access mask & LDEV 
access mask 

Blocking factor of file 
spool control flags 
spooled device flag 
spooled IN/OUT 
squeeze flags 
file squeezed 
request to squeeze 
squeeze just done 
EOF aovanced? 
last I/O: 0*read, 1=unte 
absrt brc*tn rs-read? 
EOF advanced - tape file 
for saving AC8E0FS 
EOF flags - :E0D/: 
spooled dev type/receize 
spooled dev type 
, spooled dev rec tize 
spooled dev FOPTIONS 
spoplei dev A0P1ICNS 
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ACBSPXDDX * 


RCB(43)«, 


IDD/QDD lndem 


ACBNOUAITDA « 


AC8DBL(22)», 


Nouait disc addrtss 


Spare ■ 


ACB(46)«, 


Unused 


ACBNOUAITLDEV * 


AC8(47)«, 


Nouait logical device 


ACBP1P2 


ACBD8L(24)«, 


Used by FDEVICECONTROL 


ACBP1 * 


ACB(48)«, 


II H II II 


ACBP2 * 


ACB(49)»; 




Discussion: 







ACBA80RTREAD 



ACBACCCL 



ACBACCESS 



This flag it uttd to abort a broken ttminal re-read. The 
flag it stt via tht ABORT paranettr to FUNBREAK. If tht 
flag it stt thtn tht READ PENDING nessage uill be aborted 
along uith the re-read. This feature ie needed to handle 
tht BREAK...: ABORT, etc., tituation. 

Thit it tht accttt clett part of tht dtviet typt nunbtr. 
Tht following art ltgal valutt: 

- direct (e.g., ditc) 

1 - ttrial input (t.g., card rtadtr) 

2 - parallel input/output (e.g., terminal) 

3 - ttrial input/output (e.g., nagnetic tape) 

4 - ttrial output (t.g., lint printtr) 

Thit it tht accttt bit nap for tht filt. Tht following art 
tht bit dtfinitiont of thit tight-bit fitld: 



(0:1) - « 

(1:1) - unuttd 

(2:1) - read 

(3:1) - apptnd 

(4:1) - uritt 

(5:1) - lock 

(6:1) - execute 
• tevt 



(6 : .1) -( 
(7:1) - i 



ACBAOPTIONS 
ACBBINARYIO 



Thit accttt ttcurity is dtttmintd by tht RCCCHECK intrinsic 
and enforced by tht filt oysttn. 

Thit it tht AOPTIONS in tfftct for thit filt accttt. 

Thit bit controlt full tight bit transftrt on tht 2644 pagt 
nodt ttrminal. It it adjusttd by FC0NTR0L(26) and 
FCONTR0U27). 
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PXBBLK Thit is tht block nunbtr of tht currtnt variable record 

format block. Applicable if the record format is variable. 

RCBBLKFRCT Thit ii the blocking factor for the file. It is the nunbtr 
of records in a block. Legal valuea range fron 1 to 255. 

RCBBRERK Thit it the break node flag. It it applicable if the flCB it 
for tSTOIN or ISTOUST. If act it neant that the BREAK key 
hat been hit and that the CI thould have high priority 
accest to the flCB. The flag uill be cleared uhen a RESUhE 
or RBORT it lttued. 

RCBBSIZE Thit it the block tizt, in uordt, of the file. 

RCBBTFRCT Thit it the total nunber of blockt trantferred to and fron 
the file. The initial value it OD. 

RCB8UFUSED Thit it the uord index, relative to the bate of the block, 
for the telected record uithin the block. Thit it 
applicable if the file accett it buffered. 

RCBCRRRIRGE Thit bit tignifiet that the file hat carriage control. It 
it the tane at the carriage control bit in RCBFOPTIONS if 
the file it tpooled. If not tpooled, the bit it zero, and 
IOROVE uill patt the FURITE carriage control paraneter 
directly to the driver rather than enbedding it at the firtt 
character of the output record. 

RCBCTL Thit it the CONTROL paraneter fron the latt FURITE. Thit 
value it pertinent if the file uat opened uith carriage 
control. 

RCBCURRBUF Thit it the buffer nunber (O-rtlativt) containing the nott 
recently referenced record. Applicable if the file accett 
it buffered. 

RCBORDDR Thit it the logical device nunber of the file. For a ditc 
file thit it the logical device nunber of the firtt extent. 

RCBDEFBLOCK Thit bit tignifiet that the file it to be accetted uith 
default blocking. The bit it initialized fron the FOPEN 
ttate uord STATE. It doet not need to be in the RCB; it it 
nentioned hen only to tignify that the bit it effectively 
used due to the uay RCBLSTATE it initialized fron STATE. 

RCBDISP Thit it the file elott ditpotition derived fron the FOPEN 
call. The only uay thit can be tpecified it via a file 
equation. The legal valuta art the tane at thote for 
FCLOSE. 
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ACBFKEYS Thit bit controlt the definition of the f1 and f2 function 
keys on the 2644 page node teminel; it it adjusted by 
FCQNTR0LO2) and FC0NTR0L(33). (Obtolete function) 

ACBFNUI1 File nunber, range fron 1 to 255. Uted nottly for calling 
routines that accett thingt tuch at labelt by file nunber. 

RCBFOPTIONS Thit it the FOPTIONS in effect for thit file accett. 

RCBFPTR Thit it tht sequential accett record pointer; it contains 

the next ttquential record nunber. The initial value it OD. 
Thit value it uted only by the FRERO, FURITE, and FUPOATE 
intrintict. Houever, the value it naintaintd by all data 
transferring file syeten intrinsics. 

RCBFrlRVTX This is the entry index into the file nulti-eecess vector 
table (FflRVT). Thie is valid if the file aceess is 
nulti-acceee. 

RCBGSTRTE These are niscellaneous state flags. Theee art "global" in 
nature in that they are the sane for all accessor* in a 

nulti-aeeeat enviromtent. The constituent bits art 
described individually. 

RCBGSTATUS Thie is the general part of the last I/O status for tht 
file. The foilouing art tht legal values: 

- pending 

1 - tucctttful 

2 - tnd of filt 

3 - unutual condition 

4 - irrecoverable error 

RCBHIBLK Thie it tht highttt block nunbtr for uhich an anticipatory 
rtad hat betn istutd, and it applicablt if tht filt accete 
it buffered. Tht initial value it -10. 

RCBNIT Thit it tht bufftr hit flag. If ttt it indicattt that tht 
latt rtad or uritt requett uat ttrvictd Mithout **y physical 
I/O required. This flag it uted only for performance 
neaturtntnt. The code uhich nampulattt it it optional to 
tht filt tytttn. and it controlled by conpiltr tcgglt X3. 

ACBINHIBCRLF Thit bit controlt tht ttrnination of lintt uritttn to the 

ttrninal. If not ttt thtn tach lint it ttrninated uith a CR 
and LF; if ttt then no line temination charactera are used. 
Thit bit it valid if tht filt it a ttrninal file; :t it 
adjutttd by FSETRODE. 

RCBUNECTL Thit it tht lint control bit. If not ttt thtn each lint it 
pott-tpactd; if tet then each line it prt-tpactd. Thit bit 
it uted by line printers and tew alt only. It it adjusted 
by FCONTROLU ) and FURITE uith the aopropriatt carriagt 
control. 
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RC60TYPE 



RCBEOF 
RCBEOFS 



RCBERROR 



RCBFCB 



Thit it tht filt rtftrtnet fomat type nunbtr and it dtrived 
fron tht FOPEN call. Tht foilouing art legal valuer. 

- full nana 

1 - account nant abttnt 

2 - group and account nant abttnt 

3 - null nant 

Thit infornation it nttdtd by FRENRHE. 

Thit it tht dtvict typt nunbtr of tht file. The foilouing 
are legal valuet (octal): 

- noving htad ditc 

1 - fixtd head diac 
3 - CS80 device 

7 - foreign ditc 

10 - card reader 

11 - paper tape reader 
20 - terninal 

24 - card reader/interpreter/punch 

26 - SSLC 

27 - programmable controller 

30 • nagnetic tape 

31 - atrial ditc 

40 - lint printtr 

41 - card punch 

42 - paptr tapt punch 

43 - CRLC0RP 500 plotttr 

44 - CALCOnP 600 plotttr 

45 - CALCDItP 700 plotter 

Thit bit it ttt uhtn EOF hat been eenaed. 

Thit it tht typt of EOF detected on tSTOIN(X). Thit fitld 
contittt of tuo bits: 

(0:1) - super colon (i.e., EOF for fSTDINX) 
(1:1) - regular colon (i.e., EOF for tSTOIN) 

Applicable for nulti-acctee to BSTDIN(X) only. 

Thie is the error nunber for the file. It is used by all 
intrineics except FOPEN. Uhen an error is detected the 
error nunber is placed in thie cell. The error nunber ie 
cleared at the beginning of each callable intrinsic exeept 
FCKECK (uhich reads it). 

This is the FCB vector for the file. 

disc files. 



File Syeten 

RCBLPCTL 

RCBLSTATE 

ACBROOC 
ACBNARE 
RCBNEUCOF 

RCBNOUAITEOf 
RCBNOUAITKQOC 

RCBKUASUFS 
RCBPAGECTL 



RCBPRIV 

RCBQSTRTUS 

RCBQUIESCE 



Rpplieable only to 
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Thie art tht lint and page control bits, uhich are described 
ttparattly. 

Thttt are nitctllantout ttatt flegt. Thty are "local" in 
nature in that they nay be different for each accettor in a 

nulti-access environment. Bitt (9:6) m initialized fron 
tht ttatt uord local variable called STRTE in FOPEN; the ten 
remaining bitt trt initialized individually. Tht 
constituent bitt art described individually. 

Theee are nitctllantout node flagt. Tht constituent bitt 
are dttcribtd individually. 

Thit it tht local filt none. The nant is tight bytes in 
length uith trailing blanks added. 

Thit flag uhtn set indicates that a neu tapt nark should bt 
uritttn before the tape it rewound or backspaced. 
Applicable only to nagnetic tape files. 

This bit is used to save the value of the local EOF advanced 
flag NEUEOF in IOROVE between tht I/O initiation and I/O 
completion calls. Thit flag it applicable if tht filt it 
accessed in nouait I/O node. 

Thit cell it used to tavt tht I/O nodt between nouait I/O 
initiation and completion calls. If the bit it ttt thtn tht 
latt I/O requett uat a urite; otherwise it uae a read. Thit 
ctll it pertinent if the file it accttted in nouait I/O 
node. 

Thit it tht number of buffers, lttt one, used for the file 
Applicablt if the file accete ie buffered. 



Thie ie the page control bit. If not act then a page it 
assumed to contitt of 60 lintt (auto pegt eject); if ttt 
then a pate ie aeeunad to consist of 66 lintt (no auto page 

tjtct). Thit it uted prinerily for line printers but it 
alto valid for terminals; theee ere the only devicee for 
uhich thie ie valid. Thia bit ie adjuated by FCONTROL(I) 
and FURITE uith the appropriate carriage control. 

Thie flag uhen eet indicates that the file ie privileged in 
that it hae a negative file code; the ueer nuet be in 
privileged node to acceee it. 

Thie ie the qualifying part of the laet I/O etatue for tht 
file. The values are unique for each general status part. 
See I/O Syeten IAS for all legal values. 

This bit controls critical output verification. If eet, 
buffered output ie guaranteed to have been uritten to the 
device uhen control ie returned to the uttr. Thit bit it 
adjusted by FSETRODE. 
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RCBRERDCOOE This field consists of the input EOF checking type and node, 
and it wed to generate the P1 paraneter to ATTACHIO. These 
fields art described individually. 

ACBREADflODE This field controls tht input EOF checking node. It it 00 
for reading tSTDIN. 01 for reading ISTDINX, and 10 for the 
Connand Interpreter. 

ACBREBDTYPE This field controls the input EOF checking type. It is 01 
for JOBS, 10 for SESSIONS, and 00 for DATA. 

ACBRSIZE This is the file's record size in positive bytes. 

ACBRTFRCT This it the total nunbtr of recordt trantftrred to and fron 
tht file. The initial value it 00. 

ACBSRVEEOFS Thit field it uted to save the contents of ACBEOFS during 
BREAK node processing. 

RCBSHCNT This is the total nunber of LACBs that exist for this PACB. 
Valid if the file access is nulti-access. 

ACBSHCNTIN This is tht total nunber of input-only LRCBt that exist for 
this PACB. Valid if the file access is nulti-access. 

RCBSHCNTS This is the total LACB and total input-only LACB counts, 
each of uhich is described separately. 

ACBSIZE This is the size, in uords, of the ACB. The conplete size 
(including buffers) nay be calculated fron the DST size 
containing the ACB. It does not includt tht bufftring 
extension, if prettnt. 

ACBSPAOPT Thit it the AOPTIONS for the tpooltd dtvict. Applicable 
if the file access it to a tpooltd dtvict. 

ACBSPFOPT Thit it the FOPTIONS for the tpooled device. Applicable if 
the file accett it to a tpooled device. 

ACBSPOOLEO This is the spooled device flag. If set then the file 
access is to a spooled device. 

ACBSPOOUO This field is a conbination of the spooled device flag and 
the input/output node of the spooled device. Legal values 
art: 

00 - not spooled 

01 - illegal 

10 - input spooling 

11 - output spooling 
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ACBSUBCL Thit it the tub-datt part of tht dtviet type nunber. Tht 
tub-class it unique for each access datt. Tht following 
are the legal tub-clatt valutt for tach device datt: 

- direct 

- noving htad ditc 

1 - fixtd htad ditc 
7 - foreign ditc 

1 - terial input 

- card reader 

1 - paper tape reader 

2 - parallel input/output 

- terninal 

4 - card reader/punch 

6 - SSIX 

7 • progrannable controller 

3 - serial input/output 

- nagnetic tape 
7 - serial ditc 

4 - serial output 

- line pnnttr 

1 - card punch 

2 - paper tape punch 

3 - CALCOrtP 500 plotter 

4 - CALCOHP 600 plotter 

5 - CALCOHP 700 plotter 



ACBTAPEERROR 



RCBTBLOCK 



ACBTLOG 



RCBVOAODR 



AC8XMTCRLF 



This bit controls the reporting of recovered nagnetic 
errors. If not tet the recovered errors art not reported to 
the user; if tet then recovered errort are rtporttd to tht 
user by returning CCL and error nunber 39. Valid if the 
file is a nagnetic tape filt. Thit bit it adjusted by 
FSETHODE. 

This bit controlt block nedt transftrt on tht 2644 pagt node 
terninal. This bit it adjutttd by FC0NTR0L(28) and 
FC0NTR0LU9). 

Thit it tht latt I/O transmission log for tht filt. It 
conet fron tht I/O trantnittion log part of tht IOCB 
returned by ATTACHIO. Not all RTTRCHIO calls update thit 
cell. 



This is the volune table index for the file, 
the file is a disc file. 



Applicable if 



This bit controls CR and IF insertion into tht uttr bufftr 
on the HP 2644 Page node Terninal. Thit bit it adjutted by 
FC0NTR0K3O) and FC0NTR0L(31). 
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RCBSPREC 
ACBSPTYPE 

ACBSPTYRC 
RCBSPVOEV 
ACBSPXDDX 

ACBSTATUS 

ACBSTOPCHAR 
ACBSTREAH 



Thit it the record tizt, in bytes, of the spooled device. 
Applicable if the file access is to a spooled device. 

This is the device type (fron the LOT) of the spooled 
device. Applicable if the file access is to a spooled 
device. 

This cell contains the spooled device type and record size, 
uhich »n described separately. 

This is the logical device nunber of the spooled device. 
Applicable if the file access is to a spooled device. 

This is the index into the IDD or ODD for a spoolfile. 
Applicable if the file access is to either a spooled device 
or a spoolfile. 

This is the last I/O status for the file. It cones fron the 
I/O status part of the IOCB returned by ATTACHIO. Not all 
ATTACHIO calls update this cell. 

This it the record ternination character uttd for terninal 
reads. Thit character can be changed via FC0NTR0K25). 

This bit signifies inter-block garbage for disc files. If 
set, the block size is a nultiple of 128 uords and 
therefore, there is no garbage data betueen blocks. This 
fact is used to inprove nulti record I/O by napping the 
request into as feu RTTACHIOs as possible. 
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If prettnt, tht PACB buffering extension contain* fron one to sixteen block 
buffers each having the follouing fornat: 




I 1 ' 
I 2 
I 3 
I 4* 
I 5 
I 6* 
I 7 

I 10 

I 11 

I 12 

I 13 

I 14 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
~|"I"1-|--|"I"I~I"I~I"!"M~I 

IOQ ENTRY INDEX 
1.-|~|~|~|~|~|-|~ 

BLK LDEV NUHBER I I |U |R 10 |U |n |P 
|.-|~|~|~l~l~l-|" 

IOCB - STATUS 

IOCB - TRANSniSSl LOG 

BLOCK NUHBER 



BLOCK SECTOR ADDRESS 



BLOCK EXTENT BASE 

BLOCK EXTENT SIZE 
UNUSEO 



BUFFER 



BLKIOQX 

1 BLKFLRGU 

2 BLKLSTRT 

3 BLKTLOC 

4 BLKBLOCK 
5 

6 BLKDADOR 

7 

8 BLKEXTBASE 

9 
-I 

|10 BLKEXTSIZE 
-I 
111 
-I 
|12 BLKBUFFER 
I 
I 
I 
i 
I 
I 
-I 



Other identifiers used: 

BLKFLA6U 

BLKLDEV 

8LKFLAGS 

BLKUNALLOCEXT 

BLKREVERSE 

BLKDONTUAIT 

BLKIOOUT 

BLKDIRTY 

BLKIOPEND 

BLKIOCOHP 

BLKIOCB 



BLK(1)K, 

6lKFLRGU.(0:8)d, 
BLKFLRGU. (0:S)», 
BLKFLRGU. (10:1), 
BLKFLA&U.(11:1), 
BLKFLRGU. (12:1), 
BLKFLRGU. (13:1 )N, 
BLKFLRGU. (14: 1)M, 
BLKFU>GU.(15:1)», 
8LKFLPGU.(14:2)*, 
8LK06L(1)«. 



flat, and LDEV uord 

block loaxk<ii device nunber 

block I/O flags 

block fron unalioc. extent 

FREPDBRCKURPD (not use*) 

I/O status r.ct checked 

last I/O uas arite? 

buffer nodified' 

I/O in pr„=-«8s- 

I/O conplete - not dirty 

IOCB 
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Ditcutaion: 

BLKBLOCK This it tht block nunbtr of tht data eontaintd in tht 

buf far. A valut of -10 indicates that tht bufftr it enpty. 

BLKBUFFER Thit it tht actual filt tytttn bufftr tpact. Each bufftr it 
txactly ont filt block in tizt. 

BLKDADDR Thit it tht block* t logical dtviet and atctor nunbtr. 

BLKDIRTY Thit flag it ttt if tht conttntt of tht bufftr hat bttn 
nodifitd. Uhtn tht block bufftr it rt-uatd thxt flag xt 
chtcktd to ttt if tht block nttdt to bt uritttn to tht 
dtviet. 

BLKDONTUAIT Thit bit uill bt on if tht I/O uat alrtady conpltttd via 

"OONT'UAIT" but tht ttatut hat not bttn chtcktd ytt. Chtck 
tht ttatut btfort uting tht block in tht bufftr. 

BLKEXTBASE Thit it tht ttctor addrttt of tht txtint batt in uhich tht 
block rttidtt. Thit it uttd for ditc caching. 

BLKEXTSIZE Tht tizt, in ttctort, of tht txttnt in uhich tht block 
rttidtt. Thit it uttd for ditc caching. 

BLKFLAGS Thttt art tht mtctllantout flagt attociattd with tht block, 
uhich art dttcnbtd ttparattly. 

BLKIOCB Thit it tht IOCS rtturntd by tht I/O tytttti uhtn tht block 
I/O hat conpltttd. On a blocktd I/O rtquttt thit it 
obtaintd fron tht ATTACHIO call; on an unblocktd I/O rtquttt 
thit it obtaintd fron UAITF0RI0. 

BLKIOCOHP Thit it tht bufftr nodifitd flag (BLKDIRTY) and tht I/O in 
progress flag (BLXIOPEND), uhich art dttcribtd ttparattly. 

Thit fitld it utually inttrrogattd to ttt if it containt tht 
valut 2, uhich ntant that tht bufftr hat bttn nodifitd but 
not ytt uritttn to tht dtviet. 

BLKI00UT Thit it the node of tht I/O optration for tht block. It it 
ttt by a untt and cltartd by a rtad. 

BLKIOPEND Thit it tht I/O in pregrttt flag. It it ttt if tht I/O it 

ptnding; it it cltartd uhtn tht I/O hat conpltttd. 

BLKIQQX Thit it the IOQ indtx of tht unblocktd I/O rtquttt for tht 
block. It it uttd at tht arguntnt to UAITF0RI0, uhich 
tnturtt tht conplttion of tht I/O rtquttt. 
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BLKLDEV 

BLKLSTRT 

BLKTLOG 

BLKREVERSE 

BLKUNALLOCEXT 



Thit it tht logical dtviet nunbtr of tht block. (Valid only 
for dite filet.) 

Tht I/O ttatut part of tht IOCB contittt of tht PCS nunbtr 
and tht trror codt for tht conpltttd I/O rtquttt. 

Tht transmission log part of tht IOCB it tht nunbtr of 
uordt or by ttt transferred by tht I/O request. 

Thit bit uould indicatt that ut 9rt reading back- uards fron 
a tape. Kouever, currently FREROBACK- UARDS can only be 
performed unbuffered. 

Thit bit tignifitt that tht block uat "rtad" fron an 
unallocated extent. Actually, the buffer uas amply cleared 
uith fill characttrt. Thtrefort, if a untt is atttnpttd to 
the block rttiding in thit buffer, it nutt pats through 
FCOKVBLK to allocatt tht txttnt first. 
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nu WV\ WW TO) 



The FCB eoordinattt access to a filt on a tharablt dtviet. Rt present tht 
only tharablt dtviet it a ditc, to only ditc filtt hevt FCBt. 

Tht infornation eontaintd in an FCB it dtrivtd fron tht filt ltbtl. Tht FCJ 
it uttd to hold thit infornation, rathtr than the file label, tinee it can bt 
accetttd nort quickly. 

Thtre are tuo strategies to choote fron in deciding where to place tht FCB. 
If tht filt hat bttn optntd txclutivt and no othtr process could possible 
share this filt, thtn tht FCB it placed into the PXFILE area (or in a N08UF 
txpandablt CBT if it uen't fit in tht PXFILE area or if tht progran it run 
uith NOCB). If tht filt could possible bt thared. thtn tht FCB it aluaye 
plactd in a thared control block table. Tht nunbtr of a data stgntnt 
containing a litt of thared filt tytttn data ttgntntt it ktpt in tytttn 
global location 1076 octal. The tizt of tht FCB dtptndt on tht naxinun 
nunbtr of txttntt tptcifitd at FQPEN; there art 44 (octal) uordt plus tuo per 
txttnt. Thtrt uill bt at ltatt ont extent, tinet tht fill label aluayt 
txists in tht first txttnt. Tht FCB extent nap it in time of logical device 
and ttctor nunbtr. Tht txttnt nap in tht filt labtl it in ttrnt of volune 
rathtr than logical dtviet; tht nap it convtrttd by VTABTOLDEV uhtn tht label 
it rtad, and convtrttd back by LDEVTOVTRB uhtn the labtl it uritten to dite. 

Tht Filt Control Block hat the following fornat: 



I 7 

I 1C 

I 

I 11 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

— I — I — I — I — I — I — I — I — I — I — I — ■ — • — • — I" 

1 | COflPLETE FCB SIZE 



-I- 
RESERVFD 



FOPTIONS 



DEVICE SPECIFICATION 
.., 1~| 1~| 

4 PR LK| DEVICE TYPE I C| V I |DEV SUBTYPE 

5 MO. OPENS FOR OUTPUT 
6 





1 

2 FCBFOP- 
TIONS 

3 FCBDEVICE 

4 

5 



NO. OFFUS FOR ANY nODE 



rim uuneER 



121 



EXCLUSIVE STATUS 

ci | wtabx | vnfisx 

, 1 1 



I FILE UhlT 



131 
I- 



7 FCBRIN 

8 FCBEXC- 
STAT 

9 FCBPVINFO 

10 FCBFUR 
11 
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fill CWvl WW KwU 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
— I — I — I — I — I — I — I — I — I — I — I — I — I — I — •— 

UNUSED 



UNUSED 



14 

15 

16 

17 

20 NO. USER LABELS URITTENJINQ. USER LABELS AVAIL. 16 FCBUSERLBL 

17 FCBEXTSI2E 
18 



I 



21 
22 
23 
24 
25 



I 26 GROUP KftflE - 1ST CKRR. IGROUP NAHE - 2ND CKRR. 
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31 
32 
33 
34 
35 
36 
37 
40 
41 
42 



I 

I 43 



END OF DATA POINTER 



12 

13 

14 FCBEOF 

15 



-I- 



EXTENT SIZE IN SECTORS 



-I- 



BLOCKING FACTOR | SECTORS PER BLOCK 

SECTOR OFFSET TO DATA I OISP I NO. EXTENTS-1 19 
I 1 



LAST EXTENT SIZE IN SECTORS 



NO. OPENS INPUT nODE 



27 GROUP Kftnf 
30 



-I- 



- 3RD CHAR. IGROUP HARE - 4TH CHAR. 
-1- 



GROUP KRItE - STH CHAR. IGROUP HARE - 6TH CHAR. 



•I- 



GROUP NAflE • 7TH CHAR. IGROUP NRHE - STH CHAR. 



-I-. 



1ST CKRR. | RCCT NRht - 2ND CHAR. 

- 3R0 CHAR. | RCCT NARE - 4TH CHAR. 

RCcTnARE - 5TH CHRR. I RCCT NAflE - 6TH CHAR. 



-I- 
RCCT NARE - 7TH CHAR. I RCCT NARE - STH CHAR. 



-I- 



STRRT OF FILE BLOCK KUH8ER 



— I 



20 FCBLAST- 
EXTSIZE 
21 

22 FCBGN 

23 

24 

25 

26 FCBAN 

27 

28 

29 

30 FCBSTART 

31 



CURRENT NUflBER OF DATA BLOCKS IN THE FILE I 



132 FCBEND 



133 
-I 



134 FCBHUII- 

NO. OF OPEN AND CLOSE RECORDS (ItESSAGE FILE) I OPEMCLSREC 

135 
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file Control B lock (Cont.) 



I 45 



LOGICAL DEVICE UMBER I 

FIRST EXTENT SECTOR NUHBER 



-I 
136 FCBEXTRRP 
I 
137 



— I 

I 
I 



-I- 



LOGICRL DEVICE NURBER I 



LAST EXTENT SECTOR NURBER 



Other identifier* used: 

FCBSIZE 

FCBLKST 

FCBDTYPE 

FCBCRUNCH 

FCBVERSION 

FCBSUBTYPE 

FCBOCNTOUT 

FCBOCNT 

FC8CLRSSFLG 

FCBnVTRBX 

FCBVHRSK 

FCBLBLEOF 

FCBLBL 

FCBBLKFRCT 

FCBSECTPBLK 

FCBSECTOFF 

FCBDISP 

FCBNUHEXTS 

FCBOCNTIN 

FCBLRBEL 

FCBLDEV 



FCB(O). (2:14)11, 

FCB(4). (0:2)11, 

FCB(4).(2:6)«, 

FCB(4).(8:1)«, 

FCB(4).(9:2)N, 

FCB(4).(12:4)i, 

FCB(5).(0:8)N, 

FCB(5).(8:8)i, 

FCB(9).(0:1)tt, 

FCB(9).(4:4)N, 

FCB(9).(8:8)», 

FCB(16). (0:8)1, 

FCB(16).(8:8)N, 

FCB(18).(0:8)», 

FCB(18). (8:8)11, 

FCB(19).(0:8)«, 

FCB(19).(8:3)i, 

FCB(19).(11:5)N, 

FCB(21).(8:8)i, 

FCBDBL(18)I. 

FCB(36).(0:8)», 



size in uords 

previous lock state 

device type 

pending crunch disposition 

file version (V-Delta-3) 

device subtype 

no. aecessors - output 

no. aecessors 

PV class flag 

nounted volune table index 

volune nask 

no. labels uritten 

no. labels available 

blocking factor 

sectors per block 

sector offset to data 

pending disposition 

no. extents less 1 

no. aecessors - input 

label LDEV and sector 

label LDEV 



File Systen 
FCBBLKFRCT 

FCBOEVICE 



Discussion: 
FCBRCBDST 



FCBRCBV 



This is the DST of the RCB that uas created at the sane tine 

as the FCB. This is used in conjunction uith FCBNEUFCBDST 
uhen relocating the FCB. 

This is the vector table entry of the RCB that uas created 
at the sane tine as the FCB. This is used in conjunction 
uith FCBNEUFCBV uhen relocating the FCB. 



FCBRN 



jp*v 



This is the account nan* of the file, 
length uith trailing blanks added. 
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It is eight bytes in 



r 



FCBFOPTIONS 
FCBON 

FCBLRBEL 

FCBLRSTEXTSIZE 



FCBLBL 

FCBLBLEOF 

FCBLDEV 
FCBLKST 



FCBRVTRBX 



FCBNEUFCBDST 



FCBNEUFCBV 



File Systen 



Thie is the PORTIONS in effect for the file. 

This is the group nana of the file. It is eight bytes long 
uith trailing blanks added. 

This is the logical device and sector mmber of the file 
label, uhich is the sane n the first extent descriptor. 

This is the size, in sectors, of the last extent in the 
file. If the file has one extent then this is the sane as 
FCBEXTSIZE; otherwise this value nay be different fron 
FCBEXTSIZE. This is the size of the last physical extent 
for the file; it is not the size of the last allocated 



This is the nunber of user labels allocated for the file. 
Since each label is a sector long, this is also the nunber 
of sectors allocated for user labels. 

This is the end-of-data pointer for the user labels. It is 
analogous to FCBEQF in that it represents the nunber of 
labels uritten. The initial value is 0. 

This is the logical device nunber of the first extent of the 
file. 

This is the previous lock state of the file and is derived 
fron the file label. Legal values are: 

- no accessor* 

1 - read 

2 - urite 

3 - read/urit* 

If the file resides on a private volune, then this field 
represents the nounted volune table index of the volune set 
entry on uhich the file residee. 

This is the DST of the neu FCB for the file. It is used in 
conjunction uith FCBRCBDST to nove the FCB to a systen 
(shared FCB) control block table uhen the second accessor is 
established. If this value is zero then there is no neu 
FCB; if nonzero then a neu FCB has been created. 

This is the vector table entry of the neu FCB for the file. 
It is used in conjunction uith FCBRCBV to nove the FCB to a 
systen (shared FCB) control block table uhen the second 
accessor is established. If this value is zero then there 
is no neu FCB; if nonzero then a neu FCB has been created. 
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FCBCRUNCH 

FCBDTYPE 

FCBEND 
FCBEOF 

FCBEXCLSTRT 

FCBEXTRRP 

FCBEXTSIZE 

FCBFLM 



This is the blocking factor of the file. It is the nunber 
of logical records in a physical bloek. Legal values range 
fron 1 to 255. 

This specifies the device on uhich the file resides. If it 

is positive then it represents a logical device nunber; if 
negative it represents a (negative) device class index. 

This is the pending FCLOSE disposition for the file. Legal 
values are: 

- no change 

1 - save pemanent 

2 - save tenporary and reuind 

3 - save tenporary but do not reuind 

4 - release 

7 - invalid file (file label access error) 

This bit governs if space uill be returned beyond the EOF 
upon the last FCLOSE of the file. 

- no change 

1 - return space beyond EOF 

This is the device type nunber of the first extent of the 
file. See RCBDTYPE for a list of legal values. 

Block nunber of the file's EOF, relative to FCBSTRRT. 

This is the end-of-file pointer for the file. It is a 
double integer representing the nunber of records in the 
file. It can also be vieued as the record nunber of the 
next record past EOF. 

This is the exclusive status of the file access. If -1 then 
the file is being accessed exclusively; otherwise it is the 
nunber of seni-exclusive accessor*. 

This is the extent nap of the file. The nunber of extents 
is specified by FC8NUREXTS; a OD extent descriptor indicates 
that the extent has not been allocated. 

This is the extent size, in sectors, of the file. Rll 
extents in the file except possibly the last have this size. 
This is a logical value, and legal values range fron 1 to 
65535 sector*. This restricts the naxinun file size to 
2097120 sectors (268,431,360 uords). 

This is the end-of-space pointer for the file. It is a 
double uord integer representing the naxinun nunber of 
records (fixed length record fornat) or blocks (undefined or 
variable length record fornat) in the file. 
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FCBNUREXTS This is the naxinun nunber of extents, less one, alloued for 
the file. It is not the nunber of extents presently 
allocated, uhich is aluays deternined by counting nonzero 
entries in the extent nap. 

FCBNUnOPENCLSREC Nunber of open and close records in the nessagc file. 

FCBOCNT This is the nunber of aecessors for the file. Alternatively 
it can be vieued as the nunbtr of PRCBs created for the 
fUe. 

FCeoCNIIN This is the nunber of file accessor* having input access. 

FCBOChTOUT This is the nunber of file accessor* having output access. 

FCBRIN This is the RIN nunber used to support dynanic locking 
(i.e., FLOCK and FUNLOCK) for the file. If there is no 
dynanic locking then this nunber is zero. 

FCBSECTOFF This is the sector offset fron the file label to the first 
block of the file. This is not necessarily equal to 
FCBLBL*1 since an integral nunber of blocks are allocated 
for the file and user labels. 

FCBSECTPBLK This is the nunber of sectors in a block for the file. 

FCBSIZE This is the size, in uords. of the conpletc FCB. It 
includes the extent nap. 

FCBSTRRT Block nunber of the file's start, excluding the file label 
block. 

FCBSUBTYPE This is the device subtype nunber of the first extent. 

FCBUSERLBL This field describes the user labels for the file. It 
consists of FCBLBL and FCBLBLEOF, described separately. 

FCBVERSION Starting uith V-Delta-3 this field specifies the version of 
APE a file uas created on. Legal values: 

- a file created before V-Delta-3 

1 - a file created on V-Delta-3 or later 
2,3 - currently undefined 

FCBVnflSK If the file residis on a private volune set, this bit nask 
signifies uhich volune of the set in uhich the file rttiiu. 
Bit 15 is on if it resides on the first volune, bit 14 if on 
the second, and so forth. 



G.23.00 
6- 44 



File Systen 



Fil. Lsbtl (FLAB) 



Tht filt label has tht following foroat: 



1 2 3 4 S 6 7 
l-l-l-l-l-l-l-l-j- 
0| FILE NAHE-1ST CHAR. I 



1| FILE NAHE-3RD CHAR. 



8 9 10 11 12 13 14 15 

-IHH--I--IHH--I 
FILE MROE-2H0 CHAR. |0 FLLOCNAnE 



2 
3 

4 
5 
6 
7 

10 
11 
12 
13 
14 
15 
16 
17 
20 
21 



25I 



FILE HRJ1E-5TH CHAR. 



FILE NAHE-7TH CHRR. 



GROUP NRI1E-1ST CHRR. 
GROUP MRnE-3R0 CHRR. 
GROUP NRnE-5TH CHRR. 



GROUP NAHE-7TH CHRR. 



RCCT HRI1E-1ST CHRR. 

RCCT NAHE-3RD CHRR. 

RCCT NRHE-5TH CHRR. 

RCCT NRHE-7TH CHRR. 
CRERTOR NAHE-1ST CHRR. 
CREATOR NAHE-3RD CHRR. 
CRERTOR NRHE-5TH CHRR. 



CRERTOR HRI1E-7TH CHRR. 



L0CKU0AD-1ST CHRR. 
L0CKU0R0-3RD CHRR. 



22 L0CKUOR0-5TH CHRR. 



23 L0CKU0RD-7TH CHRR. 
24| 



FILE NRHE-4TH CHRR. 



FILE HRHE-6TH CHRR. 2 
FILE NRHE-8TH CHRR. 3 



4 FLGRPNRnE 

5 
6 
7 



GROUP NRHE-2N0 CHRR. 
GROUP MRHE-4TH CHRR. 
GROUP NRHE-6TH CHRR. 
GROUP NRHE-8TH CHRR. 

RCCT NRHE-2ND CHRR. 8 FLRCCTHRHE 

RCCT HRK-4TH CHRR. 

RCCT NRHE-6TH CHRR. 

RCCT NAHE-8TH CHRR. 
CRERTOR HRflE-2H0 CHRR. 
CRERTOR HRHE-4TH CHRR. 
CRERTOR MRHE-6TH CHRR. 
CRERTOR HRHE-8TH CHRR. 



9 

10 



L0CKU0RO-2HO CHRR. 
L0CKU0R0-4TH CHRR. 



L0CKU0R0-6TH CHRR. 



L0CKU0RD-8TH CHRR. 



SECURITY RRTRIX 






261 FILE LRNGURGE RTTRIB. I 



-M-l 

|SR| SI22 
-l-l-l 



11 

12 FLUSERIO 

13 

14 

15 

16 FLLOCKUORD 

17 

18 

19 

20 FLSECIW 

21 
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I 108 

I 109 

I 156 

I 157 

i 160 

I 161 

I 162 

I 163 

I 164 

I 165 

i 166 

I 167 



Filt Lihtl (Cent.) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

— • — I — I — I — I — I — I — I — I — I — I — I — I — I — I — ! 



VOLUK TABLE INDEX | 
LAST EXTENT SECTOR NUftBEft 



FILE ALLOCATION TIRE 



FILE ALLOCATION DATE 



UHUSEO 



STRRT OF FILE BLOCK NUltSER 



BLOCK HUflBER OF EHO OF FILE 



NUnBER OF OPEN RNO CLOSE RECORDS 
(HESSRGE FILE) 



LAST FILE flOOIFICRTIW THE 



-I- 



I 1701 Volune Table Indtx | Pext (HODA) 
| J 

------ (looa) 



154 FLALLOCTinE 

155 

110 FLALLOCOATE 

111 

112 FLSTRRT 

113 

114 FLENO 

115 

116 FLNUnOPEMCLSREC 

117 

118 

I 
119 

120 FLPEXT'I 
-I 

1121 
-I 



FLHOOTinf 



I 171| Pseudo Extent eector 
| 1 

I 172|File libel cxten. size (Security extention size I 122 FLPEXT'SIZE 

| 173| UHUSEO M23 

| 1 1 

| 1741 DEVICE NRItE-IST CHRR. | DEVICE WH1E-2ND CHRR. |124 FLDEVHAIIE 

| 1 75 f DEVICE HAHE-3R0 CHRR. I DEVICE HAHE-4TH CHAR. |125 
| 1 1 

| 1761 DEVICE HAHE-5TH CHAR. | DEVICE HAHE-6TH CHAR. I 126 
| 1 1 

| 1771 DEVICE HRnE-7TH CHAR. | DEVICE HAHE-8TH CHAR. |127 
, 1 1 
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F|U Ubtl fCont.) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

,.V m --i--i--i--m--i--i--i--i--i--i-i--i 

27 | CREATION DATE |23 



30 | LAST ACCESS DATE 

31 1 LAST nODIFICATION DATE 



32 1 FILE CODE 
l-l 1 

33 | C| I HVTHBX 



VHASK 



DISC TYPE 



37 
40 



43 



45 
46 



50 



I 55| 



1 

I24 
1 

1 25 
1 

1 26 
1 

I27 
I 1 

I R/U 1 28 
I 1 



34 | SI R| LI X| SUBTYPE I 

--M--I--I 1 

35 NO. USER LABELS URITTEN|HO. USER LABELS AVAIL. 1 29 
1 1 

1 30 
FILE LWIT 



FCB VECTOR 



CHECKSUH 
COLD LORD ID 



FOPTIOHS 



RECORD SIZE IH BYTES 



I 

131 
-I 

I32 

I 

1 33 
-I 

I34 
-I 

I35 

I 

1 36 

I 

I37 

I 

1 38 



BLOCK SIZE IN UORDS 

SECTOR OFFSET | V I I NO. EXTENTS-1 1 39 
1 1 - 1 j 

LAST EXTENT SIZE IN SECTORS I 40 

EXTENT SIZE IN SECTORS |41 

END OF DATA POINTER I 

143 

V0LUT1E TRBLE INOEX | |44 

1 | 

1ST EXTENT SECTOR HUflBER |45 
1 



FLCRERTE 

FLLASTACC 

FLLASTHOD 

FLFILECODE 

FLPVINFO 

FLLOCK 

FLUSERLBL 

FLFLM 

FLFCBVECT 

FLCHECKSUn 

FLCUD 

FLFOPTIONS 

FLRECSIZE 

FLBLKSIZE 



FLLRSTEXT- 

SIZE 

FLEXTSIZE 

FLEOF 



FLEXTHRP 
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Other identifier! used: 

FLSECURE * FLRB(22).(15:1)i, 

(FLSRRELEASE)* FLAB(22).(14:1)», 

FLCLASSFLG » FLPVINFO. (0:1)11, 

FUWTABX ■ FLPVINFO. (4:4)11, 

FLVHASN « FLPVINFO. (8:8)N. 

(FLSTORE) « FLAB(28).(0:1)N, 

FLRESTORE * FLAB(28).(1:1)N, 

(FLLOAO) * FLA8(28).(2:1)N, 

FLEXCL • FLFB(28).(3:1)«, 

FLSR * FLA8(28).(0:2)«, 

FLSRL « FLAB( 28). (0:3)11, 

(FLSRLX) « FLAB(28).(0:4)N, 

FLSUBTYPE * FLAB128). (4:4)11, 

FLDTYPE » FLRB(28).(8:6)N, 

FLSTATUS « FLAB(28). (14:2)N, 

(FLLBLEOF) • FLA8(29).(0:8)N, 

(FUJI) • FLAB(29).(8:8)N, 

FLSECTOFF > FLAB(39). (0:8)», 

FLVERSIOH - FLAB(39).(8:2)«, 

FLXUPEXTS « FLAB(39).(11:5)«, 

FLLABEL « FLABD8L(22)#, 

FLVTAB » FLPB(44).(0:8)«, 

FLALLOCTIHE * FLABD8L(54)N, 

FLALLOCOATE ■ FLAB(110), 

FLSTART • FLRB08L(56)«, 

FLEND * FLA80BL(57)« t 
FLKUnOPENCLSREC FLAB08L(5S)N, 

FU10DTWE « FLABD8L(59;*, 

FLPEXT'ADOR * FLABOBL(60)«, 

FLPEXT'SIZE • FLAB(122)A. 

FLFLAB'EXT'SIZE « FLPEXT'SIZE. (0; 

FLSEC EXT 'SIZE * FLPEXT'SIZE. (8: 



file secure bit 
STORE/RESTORE released bit 
Class flag bit 
Hounted volune table index 
Volune nask 
file being stored 
file being restored 
file loaded 
exclusive access 
S & R bits 
S, R, & L bite 
S, R, L, & X bits 
device subtype 
device type 
urite/read atatus 
no. labels uritten 
no. labels available 
sector offset to data 
file version(>*V-Delta-3) 
no. extents less 1 
label VTRB and sector 
label VTRB index 
tine allocated on this systen 
date allocated on this systen 
starting block nunber 
ending block nunher 
nunber of open, close records 
last tine file uas nodified 
start address of pseudo extent 
pseudo extent size 
:8)», 
:8)N 



Discussion: 
FLACCTNAHE 

FLALLOCOATE 
FLALLOCTWE 

FLBLKSIZE 



This is the account nana of the filt. It is eight bytee in 
length uith trailing blanke added. 

Oate that the file uas allocated on this systen. 

Double-uord containing the tine that t(-t file uas allocated 
on this systen. 

This is the block i.re, in stttors, of the file. 



>p* x 



■n 



\ 



G.23.00 
6- 48 



Filt Systen 



FLCHECKSWl This it the exclusive-OR checksun of the filt label 

^eluding uords 34, 42, and 43 octal) and it uttd for trror 
detection. Each tine tht filt labtl it read fron ditc tht 
chtcktun it calculattd and conpartd against tht value 
recorded in tht filt labtl. Swilarly, tach tint tht filt 
label it uritttn to tht ditc tht chtcktun it calculattd and 
inserted into tht filt labtl. 

FLCLID Thit it tht cold load nunbtr in tfftct tht latt tint that 
tht filt uas accttttd. Thit thould alueys bt tht currtnt 
cold load nunbtr. If it it not, it ntant that tht tysttn 
crathtd uhilt tht filt uat optn and that tht data in tht 
filt labtl thould bt "reset" (principally tht FCB vtctor 
FLFCBVECT). FLCREATE Thit it tht crtation datt of 
tht filt. It it in tht fomat dtfintd by tht CALENDAR 
intrinsic. 

FLDEVNAHE Thit it tht FOPEN dtvice tptcification that uat uttd uhtn 
tht filt uat creattd. Thit information it nttdtd uhtn ntu 
extents art allocattd. 

FLDTYPE Thit it tht dtvict typt nunbtr of tht first txttnt of tht 
filt; ttt RCBOTYPE for a litt of ltgal valuta. Thit valut 
is dtttrnintd by configuration. 

FUND Nunbtr of current data blockt (that it, tht tnd of filt 
block nunbtr rtlativt to tht ttart of filt). Valid for 
variable and ntssagt filtt only. 

Fi£0F Thit it tht tnd-of-filt pointtr for tht filt. It it a 

doublt uord inttgtr rtprtttnting tht nunbtr of rtcordt in 
tht filt. It can alto bt vitutd at tht record nunbtr of tht 
next record patt EOF. 

FLEXCL Thit it tht txdutive accats flag for the filt. If ttt it 
ntant that tht filt hat bttn optntd txclutivtly by a tinglt 
acctttor. If not ttt then tht filt it potentially 
aeetttible by others. 

FLEXTHAP This is the extent nap of the file. The nunbtr of txttntt 
it tptcifitd by FLNUnEXTS; a 00 txttnt dttcnptor indicattt 
that the extent hat not bttn allocattd. 

FLEXTSIZE Thit it the extent tizt, in ttctors, of tht filt. Rll 

txttntt in tht filt, txctpt tht latt, havt thit txttnt tizt. 
Thit it a logical valut, and ltgal valuta rangt fron 1 to 
65535 ttctors. Thit linitt tht naxinun filt tizt to 2097120 
ttctors. 
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FLFCBVECT 



FLFILECOOE 



Filt Sytttn 



If nonztro, thit it tht vector of the FCB for the filt. If 
ztro, tht filt it not bting accttttd. 

Thit it tht filt codt of the file. Known valutt are: 

Filecode Rnenonic Explanation 

1024 US I Uter Subprogran Library 

1025 8RSD Basic Oata 

1026 BRSP Batic Prog ran 

1027 BRSFP Basic Fast Progran 

1028 Rl Relocatable library 

1029 PROG Progran File 

1030 NHPRG Native Rode Progran 

1031 SL Segnented Library 

1032 NHXL Native node External Library 

1033 NP.RL Native Rode Relocatable Library 

1035 VFORH Vieu Fom File 

1036 VFRST Vieu Fast Forns File 

1037 VREF Vieu Refomat File 

1040 XLSRV Cross Loadtr RSCII Filt (SAVE) 

1041 XLBIN Crott Loadtr Relocated Binary Filt 

1042 XLDSP Crott Loadtr ASCII Filt (DISPLAY) 

1050 EDITQ Edit Quick File 

1051 EDTCQ Edit KEEPQ File (COBOL) 

1052 EOTCT Edit TEXT File (COBOL) 

1054 TOPOT TOP Diary File 

1055 TDPQH TDP Proof narked QHRRKED 

1056 TDPP TDP Proof narked non-COBOL File 

1057 TDPCP TDP Proof narked COBOL File 

1058 TDPQ TDP Uorkfile 

1059 TDPXQ TDP Uorkfile (COBOL) 

1060 RJEPN RJE Punch File 

1070 QPROC QUERY Procedure File 

1080 KSRmc KSRH Key File 

1083 GRAPH GRAPH Specification File 

1084 SD Uter Logging Log File 
1090 LOG Self-detcribing File 

1100 UDOC HPUORD Docuntnt 

1101 UDICT HPUORD Hyphenation dictionary 

1102 UCONF HPUORD Configuration Filt 

1103 U2601 HP 2601 Environntnt Filt 

1110 PCELL IDS/3000 Character Ctll Filt 

1111 PFORH IDS/3000 Fom Filt 

1112 PENV IFS/3000 Environntnt File 

1113 PCCHP 

1114 RRSTR Graphict Inage in RASTR Format 

1130 OPTLF OPT/3000 Leg Filt 

1131 TEPES TEPE/3000 Script File 

1132 TEPEL TEPE/3000 Log File 
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1133 


SRRPL 


RPS/3000 Log File 


1139 


HPEDL 


nPEDCP/DRP Log File 


1140 


TSR 


HPToolttt Root File 


1141 


TSD 


KPToolstt Data File 


1145 


DRAU 


Drauing File for HPDRRU 


1146 


FIG 


Figurt Filt for KFDRRU 


1147 


FONT 


Font Filt for HFDRRU 


1148 


COLOR 


Color Definition File 


1149 


D48 




1152 


SLATE 


Conprttttd SLATE File 


1153 


SLATU 


Expanded SLATE Uorkfilt 


1156 


DSTOR 


Store Filt for RAPID/3000 Utility DICTDBU 


1157 


TCOOE 


Codt Filt for Transact/3000 Conpiltr 


1158 


RCOOE 


Codt Filt for Report/3000 Conpiler 


1159 


ICODE 


Code File for Inforn/3000 Conpiler 


1166 


HOIST 


KPDESK Dittribution list 


1167 


HTEXT 


KPDESK Text 


1168 


nRRPR 


RRPR ntttagt Filt 


1169 


HRRPO 


ARPR Dittribution List 


1170 


ncnxD 


KPDESK Abbreviated Cormands File 


1171 


nFRTn 




1173 


HEFT 




1174 


HCRPT 




1175 


nSERL 




1176 


VCSF 




1177 


TTYPE 


Tern Type File 


1178 


TVFC 


Tern Vertical Fornat Control File 


1192 


NCOHF 


Netuork Configuration File 


1193 


NTRRC 


Netuork Trace File 


1194 


NLOG 


Netuork Log File 


1195 


niDAS 




1211 


NDIR 


RNODE 


1212 


INODE 


INODE 


1213 


INVRT 




1214 


EXCEP 




1215 


TAXON 




1216 


QUERF 




1217 


OOCOR 




1226 


VC 


VC File 


1227 


DIF 


DIF File 


1228 


LANGD 


Language Definition File 


1229 


CHARD 


Character Se* Definition File 


1230 


HGCAT 


Formatted Application nessagc Catalog 


1235 




Reserved 


1236 


enfiP 


P.RP File 


1242 


BDRTR 


BASIC Date File 


1243 


BFORfl 


BASIC Field Order File for VPLUS 


1244 


BSRVE 


BASIC Saved Progran File 


1245 


BCNFG 


Config. File for default Ootion BASIC prrsran 


1246 


BKEY 




1247 


WIBSU 


Business Basic/XL Progran File 


1248 


NnBDT 


Business Basic/XL JR T « Filt 


1249 


CHBBN 


Business BasicA' w irary til" 



File Systen 



1258 

1259 

1270 

1271 

1272 

1273 

1275 

1276 

1401 

1421 

1422 

1425 

1428 

1429 

1430 

1431 

1432 

1433 

1434 

1435 

1436 

1437 

1438 

1441 

1461 

1462 

1476 

1477 

1478 

1479 

1480 

1483 

1484 

1485 

1486 

1491 

1500 

1501 

1502 

1514 

1521 

/ 8000 
< to 

\ 8099 



PFSTA 

PFDYN 

RFDCA 

FFDCA 

OIU 

POOC 

DFI 

SRI 

CUPTX 

HAP 

GAL 

TTX 

ROIC 

RSPEC 

RSPCF 

REXEC 

RJOB 

ROUTI 

ROUTD 

PRINT 

RCONF 

ROICN 

REXKH 

PIF 

NHOBJ 

PRSLB 

TIFF 

RDF 

SOF 

GPH 

GPD 

VCGPH 

FRHAT 

DUHP 

Nunoo 

X4HDR 

UP1 

UP2 

L0123 

FTCF 

DSKIT 



Pathf lou STATIC File 
Pathf lou DYNAniC File 
Revisable Form OCA Docuntnt 
Final Form OCA Docuntnt 
Docunent Interchange Unit File 
KPU0R0/150 Docunent 



KPnRP/3000 (lap Specification File 



KPBRU Dictionary File 
KPBRU Execution File 



Tag Inage File Format 

Revisable Docunent Format 

Serial Object File Fornat 

Chart File for Charting Gallery Chart 

Data File for Charting Gallery Chart 

Formatter 

Dunp File 

Neu Uavc nail Distribution 

X.400 Header 

Other UP1 

Other UP2 

Lotus 123 Spreadsheet 

Forms tester Cnd Spec 

HPDesk Intrinsics Transaction 



FLFLM 
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Reserved for APL 

This is the tnd-of-tpact pointer for the filt. It it a 
doublt inttgtr rtprtttnting the naxinun nunbtr of records 
(fixed ltngth record fornat) or blockt (undefined or 
variablt length record format) in the file. 

Thit it the FOPTIONS of the file. 
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FLGRPNRHE 



FLLRBEL 



FLLRSTflCC 



FLLflSTnOD 



FLLRSTEXTSIZE 



FLUL 



FLLBLEOF 



FLLOCK 
FLLOCKUORO 



FUIODTME 
FLNUF1EXTS 



File Sytttn 

This it tht 9 roup nant of tht filt. It it tight byttt long 
uith trailing blanks addtd. 

Thit it tht volunt tabit indtx and ttetor mmbtr of thi filt 
label, which it tht tant tt tht first txttnt descriptor. 

Thit it tht lttt tcettt dm of tht filt. It it in tht 
fornat defined by tht intrinsic CALENDAR. 

This it tht last notification date of tht filt. It it in 
tht fornat dtfintd by tht intrinsic CALENDAR. 

Thit it tht tizt, in sectors, of tht latt txttnt in tht 
filt. If tht filt hat ont txttnt, thtn thit it tht tant at 
FLEXTSIZE; if tht filt hat nort than ont txttnt, thtn thit 
valut n»y bt difftrtnt fron FLEXTSIZE. This is the sizt of 
tht latt phytical txttnt for tht filt; it it not tht tizt of 
tht latt allocated txttnt. 

Thit it tht nunbtr of uttr labtlt allocattd for tht file. 
Since tach labtl it a ttetor long, thit it alto tht nunbtr 
of ttctort allocattd for uttr labtlt. 

Thit it tht tnd-of-data pointtr for tht uttr labtlt. It it 
analogout to FLEOF in that it rtprtttntt tht nunbtr of 
labtlt uritten. 

Thit it tht LORDED flag for tht filt. If ttt, it ntant that 
tht filt it a loadad progran or SL filt and cannot bt 
nodifitd txctpt by a priviltgtd acctttor. Thit flag it ttt 
and eltartd by tht loadtr, not tht filt tytttn. 

Thit idtntifitt tht uord containing tht lock bitt, uhich art 
dt scribed ttparattly. 

Thit it tht lock uord of tht filt. It it tight byttt long 
uith trailing blinks addtd. If it it all blanks, thtn tht 
filt dots not havt a lockuord. FLLOCNRIIE Thit it tht 
local nant of tht filt. It it tight byttt long uith 
trailing blinks addtd. 

Latt tint tht filt uat nodifitd. 

Thit it tht nunbtr of txttntt, lttt ont, alloutd for tht 
filt. It it not tht nunbtr of txttntt allocattd. Ltgal 
valutt rangt fron to 31, i.t., 1 to 32 txttntt. 



FLNUHOPEKCLSREC Nunbtr of eptn and elett records in tht ntttagt filt. 
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FLPEXT'RDDR 

FLPEXT'SIZE 



FLPVINFO 

FLRECSIZE 
FLRESTORE 



FLSECHX 



FLSECTOFF 



FLSECURE 



Thit hat tht ditc addrtss of tht start of tht pstudo txttnt 
(RCD) that has bttn attachtd to thit filt. Tht high ordtr 
bytt containt tht volune tabit indtx, tht rtnaining 24 bitt 
contains tht ttetor address. 

This uord holds tht tizt of tht pttudo txttnt. It it broken 
up into tuo halves of ont bytt tach. The high order bytt 
holds tht tizt of tht filt label extention(not currently 
inplenented), and the lou order byte contains the size of 
the RCD (security extension). Both sizes are in sectors. 
The pseudo extent is partitioned into tuo extensions, uith 
the security extension aluays appearing first, and the file 
label exttntion apptaring afttr. 

Filt label private volune information. Thit it in tht tant 
fornat as tht FCBPVINFQ. 

Thit it tht rteord tizt of tht filt in ntgativt byttt. 

Thit it tht RESTORE flag for tht filt. If ttt, it ntant 
that tht filt it bting RESTOREd and cannot bt accttttd. 
RESTORE alto tttt tht STORE bit for tht filt (FLSTORE); ttt 
FLSR for a full description of tht ust of thttt bitt. Thit 
flag it ttt and eltartd by STORE/RESTORE, not tht filt 
tytttn. 

Thit it tht ttcunty natrix of tht filt. Tht bitt art 
organiztd into five groupt of tix bitt tach. (Bitt 0:2 art 
not used.) The groupt correspond to the access types: RERD, 
RPPEND, URITE, LOCK, and EXECUTE. Uithin each group, tach 
bit tptcifitt uho nay havt tht acctts: RNY, RCCOUNT H6R, 
ACCOUNT LIB- RRRIRN, GROUP, CROUP LIBRARIAN, CRERTOR. 

This it tht ttetor off ttt fron tht filt labtl to tht firtt 
block of tht filt. Thit it not ntetttanly equal to 
FLLBL*1 tinct an inttgral nunbtr of blockt art allocattd for 
tht filt and uttr labtlt. 

Thit is tht filt tteurity tnforctntnt flag for tht filt. If 
not stt, thtn tht filt hat bttn RELERSEd and tht tteurity 
natrix FLSECHX should bt ignored. If ttt, thtn secure at 
tptcifitd by tht tteurity natrix. 



f&^K 
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FLSR 



Filt Sytttn 



Thit it tht STORE and RESTORE flags for tht filt, uhich art 
described ttparattly. STORE and RESTORE decode tht tuo-bit 
field to indicate their operation. Ltgal values art: 

- filt not in use by tithtr STORE or RESTORE 

1 - illegal valut 

2 - filt bting STOREd 

3 - filt bting RESTOREd 

Tht filt tytttn inttrprttt tht ltftnott bit as indicating 
that tht filt it bting acctsstd by tithtr STORE or RESTORE. 
Tht rightnott bit it interprtttd as indicating uhat accttt 
thould bt ptmitttd: (filt being STOREd) allout read 
accttt; 1 (filt bting RESTOREd) allout no aectss. Thit 
fitld it ttt and rtttt by STORE/RESTORE, not tht filt 



FLSRL 



FLSRLX 



FLSRRELERSE 



FLSTRRT 



FLSTATUS 



FLSTORE 



Thit it tht STORE, RESTORE, and LORDED flagt for tht filt. 
uhich art described stparattly. 

Thit it tht STORE. RESTORE, LORDEO, and exclusive flags for 
tht filt, uhich art dttcribtd teparately. 

Thit flag it ustd by STORE/RESTORE. If a filt it STOREd 
uith tht "; RELEASE" ktyuord, STORE uill ttt thit flag in tht 
tapt copy of tht filt labtl. RESTORE uill allou any uttr to 
accttt tuch filtt, rtgardlttt of tht file's nomal tteurity. 
If thit bit it off in tht tapt copy of tht filt labtl, 
RESTORE applitt nomal tteurity checks (at dtfintd by tht 
infomation in FLSECnX and FLSECURE). Thit bit it ztro for 
filts on disc. 

Block nunbtr of the file's start, excluding the file label 
block. Valid for variable and ntttagt filtt only. 

Thit it tht read/write status of tht filt. Ltgal valutt 



- no accessor* 

1 - read 

2 - uritt 

3 - rtad/uritt 

Thit it tht STORE/RESTORE flag for tht filt. If set it 
neant that the file it being either STOREd or PESTCREd. 
The RESTORE bit (FLRESTORE) mist be interrogated to 
detemne uhieh operation ie taking place; see FLSR for 
a full description of the use of these bits. This flag 
it ttt and eltartd by STORE/RESTORE, not tht filt 
tytttn. 



Filt Sytttn 
FLSUBTYPE 
FLUSERID 
FLUSERLBL 

FLVERSION 
FLVTRB 



Thit it tht device subtype nunbtr of tht firtt txttnt of tht 
filt. Thit valut it dtttrnintd by configuration. 

Thit it tht creating user nant of tht filt. It it tight 
byttt long uith trailing blanks addtd. 

Thit fitld describes tht uttr labtlt of tht filt. It 
consists of FLLBL and FLLBLEOF, uhich art described 
ttparattly. 

Starting uith V-Delta-3, thit fitld tptcifite tht ItPE 
version that a file uat created on. Ltgal valutt: 

- a filt created before V-Delta-3 

1 - a file created on or after V-Dtlta-3 
2,3 - currently undefined 

Thit it tht volunt tabit index of tht firtt extent of tht 
filt. 
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File Sytttn 



f ^ flulti-WcMn Victor U* \» fPflflVT) (DST XS4) 



Tht FIWVT it uttd to locatt thartd PACBt for filtt optntd nulti-accttt. Uhtn 
In Aid disc filihas been opined nulti-aecees, the FIWVT it searched to 
2tHl»SVtta file hit previously been opened. The JITOST and the DADDR 
Jaund in thl FRAVT are conja™ to the JITOST of the job and the DflDDR of the 
Jmce oV 5!.c fi • blinT&ned nulti-acce... If an entry «*i.ts for the 
fill then S5 PRCB can be easily located for that file. If this is the 
fiSt ^ess opening the file, then an entry is created and inserted into 
the FIWVT for the file. 

Spoolfilet art opened nulti-accees. therefore, they uilljwn tntriet in the 
HWVT. ISTDIN and ISTDUST alto have entnet in the FIWVT tinct they too an 
opened nulti-accett. 



?ero Entry Fornat 



CURRENT TABLE SIZE 



ENTRY SIZE • 6 



iwxwun TABLE SIZE 




FIT CURR' SIZE 
FIT ENTRY' SIZE 

fit iwx 1 size 



Descriptions: 

FA'CURR'SIZE Tht currtnt tizt ofthe FRAVT in uordt. Thit wlHtanMi 
in lncrenentt of X200 Mordt until FITIWX'SIZE it rtachtd. 

FIIWSIZE The naxinun allouablt tize in uordt that «• WOW^Xtt eg 
get. The current value of thit is X4000. FIT IWX SIZE can be 
chanted only by changing the code in Initial. The open of tht 
nulti-accett filt it failtd if thit naiunun it rtachtd. 

Fll' ENTRY 'SIZE Sizt in uordt of an FIWVT tntry, 6 uordt tt prtttnt. 
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Svsten Glob al Rrta (SVSGL08) 



Filt Sytttn 



Tht filt tytttn uttt ttvtral uordt in tht tytttn global trta for itt i 



SHFCBOST 
INMITOR » 

IWXSSECT > 
NU11SSECT * 
EXTSSECT ■ 
SPOOLIHOEX > 
CSIOURIT « 
CCL0SEPLA8L • 
OSCHKPLABL » 
DS0PENPLA8L ■ 
DSCLOSEPLABL • 
SDSLDEVLABEL ■ 
IWNUCPLRBL • 
GLOBRLRFTOST • 



SYS08*X76, 

SYSD9*X77, 

SYSDB*X100, 

8YSDB*X102, 

SYSDB*X104, 

SYS0B*X132» 

SYSDB*X135, 

SYS08*X140, 

SYSD8*X335, 

SYS06 41336, 

SYSD8*X337, 

SYS08+X323, 

SYSDB*X340; 

SYSGLBEXT*X121 



shared CBT DST no. 
nonitoring flag uord 
mm « tpoolfilt ttctort 
currtnt « tpoolfilt ttctort 
« ttctort/tpoolfilt extent 
clatt tpool index 
CSIOURIT PLRBEL 
CS CCLOSE PLRBEL - FPtOCTEMI 
DSCHECK PLRBEL 
DSOPEN PLRBEL 
OSCLOSE PLRBEL 
PLRBEL for SOSLOEV 
nRNRGEURITECONV PLRBEL 
Global RFT DST nunbtr 



sib.. Lockt. and Ptadlockt 



Tht filt tytttn utet tuo SIRt: tht Filt SIR, uhich it inttndtd to P«** 
file labtl integrity, and tht FIWVT SIR, uhich it to guarantee tht integrity 
of the FIWVT. lince tht filt tytttn lockt thttt rttourctt and alto lockt 
control blockt, dtadlockt can occur if locking it done in the urong ordir. 
Not only nust tht filt tytttn handle locking corrtctly, but the «ntirt 
ensenble of the file systen, its callers, and its calleea nust do so alto. 
These include KSRn. uhich hat a SIR of its oun SYSOURP, and STORE, uhich 
lock tht Filt SIR btcause they tueak bitt in filt labtlt. Tht prtttntiy 
accepted ordtr it: 

Get FIWVT SIR 
Uck RCB 
Get File SIR 
Uck FCB 

It nay not be necessary to do all of these thingt in any particular 

procedure. In nodifying a procedure, you should be surt that any of these 
locks uhich you change *rt consistent not only uithin your oun code, but alto 
uith its calltrt and callees. 
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File Systen 



Tyoical Entry Fornat 



1 2 3 4 5 6 7 8 910 11 12 13 14 15 

i| el oi msi^ JO 

■"•"jiT'wT "^.ZZZZZi 1 Fn ' JIT0ST 

logkrl"device™"i " 12 Fn, ° RDW 

DISC ADDRESS > 3 



PRCB VECTOR 



— I 

|4 FR'PRCBV 

I 
15 



FIT DEVICE « 
FIT GLOBAL ' 
Ffl* LDEV 

Descriptions: 



FIWVT(0).(2:l)i, Device bit 
FIWVT(0).(1:1)N, Global nulti-accett bit 
FITDADDR(O). (0:8)11, Logical device nunber of file 



Fn* DflDDR 

FH' DEVICE 
Ffl' LDEV 

FIT JITOST 



FII'GLOBRL 
FR'PRCBV 



The disc addrttt of the file label for ditc filet. For device 
filtt, tht ditc addrttt is zero. 

Thit bit it 1 for dtvict filtt and for ditc filet. 

Logical dtvict nunbtr of dtvict filtt or tht LDEV of tht ditc 
containing tht filt labtl for ditc filtt. 

Tht DST nunbtr of tht JIT for tht job that hat tht file open. 
If thit fitld it nonztro, thtn only processes in tht famly 
trtt of thit particular job can optn tht filt. Thit fitld it 
zero if tht filt uat optn global nulti-accttt. 

Thit bit it 1 if tht file uat optned global nulti-accttt, thit 
allout nulti-accttt to tht file bttuttn jobt. 

Tht PRCB vtctor for thit nulti-accttt filt. Uttd to tatily 
find tht Phytieal Rccttt Control Block for filtt optntd 
nulti-accttt. 
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Filt Sytttn 



Shared CBT DST 



In tytglobal X76 (RBSOLUTE X1076) thtrt titittt tht thartd Control Block Tablt 
DST nunber. Thit DST hold, a li.t of thartd CBTt. Shartd CBTt art uttd to 
kttp any and all filt tytttn control blockt that have the Potential to be 
thartd bttuttn processes. Any ditc filt optntd thartd mil have itt FCB kept 
in one of thttt CBTt. Alto, ill ttminal PACBt uill be ttortd m a systen 
thartd CBT to that an antra data ttgntnt is not uasted. This is possible 
because all teminal access is ptrfomtd NOBUF, uhich ntans that tht PRCB 
uill bt a nininal PACB and can bt plactd in thttt CBTt. Lastly, any file 
optntd uith global filt accttt uill havt all itt control blockt plactd into 
thttt tytttn CBTt. 

Tht fornat of tht tytttn thartd CBT DST it tinilar to a Control Block Tablt. 
It hat tht tent uordt of ovtrhtad and tht data (tht iitt of DSTs) starts in 
tht next uord after the ovtrhtad. Tht tytttn CBTt art crtattd one at a tint 
at needed. Usually, thtrt art only a ftu DSTt in tht litt. 



TABLE SIZE IN UORDS (X200) 



DST NUItBER OF THIS TRBLE 



6 

7 

10 
11 
12 



1ST. SHARED CBT DST WJH.BER 



2ND. SHRRED CBT DST AMBER 



|9 
-I 
110 



177| 118TH. SHRRED CBT DST MINER 



1 

M27 
1 
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P recti* Tablts 



CMPTF.R7 PROCESS TABLES 



The operating eysten naintaina atatt, control, and accounting information on 
tach process. Tho data structures for this purpost art tht process control 
block table (PCB; core resident, 1 entry per process) and the process control 
block extension (PCBX; contained in the process* staek belou OL). Process 
related information uhich nust be accessible uhtn the process' stack is not 
prtstnt in nain nenory is naintained in the process* PCB entry, fill other 
process related infornation is naintained in tht proctss* PCBX. 

R proctss it idtntifitd in tht sytttn by its PCB tntry nunbtr, rtftrrtd to as 
its PIM (proctss idtntification nunbtr), or by its PCBPT«(PIN)*(PC8 tntry 
size). 

The structure of tht PCB table, PCB entry fornat, PCBX structure, and PCBX 
format are specified in this chapter. 

Prgetti Control Block Table Structure and Fornat 
Fixed Cells Relattd to PCB 

| RBS(4) PCB relative index of current process' PCB entry 
X1003 SYSGUJB rtlativt address of tht PCB tablt base 

The bank 8. address arc rtprtstnttd as ptr the flPEV ERS. 
X1271 PCB rtlativt address of htad of dispatching queue's PCB 

tntry 
X1272 PCB rtlativt addrtss of tail of dispatching queue's PCB 

entry 



Proctss Tablts 



PCB Entry Fornat 
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Unassiontd PCB Entry Fornat 



Process Tablet 



I 0| 
I- 



— I 
10 



1 j TABLE RELATIVE INDEX TO NEXT UNASSIGNEO |1 
| ENTRV I 

, -j 



24| Z177777 



-I 

I20 
-I 



Note: Only word 1 and uord 20 art valid for an unassigntd PCB tntry. 
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0| i OF CONFIGURED ENTRIES 
1 | ENTRY LENGTH (Z2S) 



I- 

I 21 
I- 

1 3 ! 

I- 

I 4| 



• OF UNASSIGNEO ENTRIES 



M 
-I 
12 



TABLE RELATIVE INDEX TO FIRST 
UNASSIGNEO ENTRY 

TABLE RELATIVE INDEX OF LAST 
FREE ENTRY 



/ ***^ 



I 5| 

I- 
I 



HIGH UATER flRRK 



6 | NUMBER OF PRIMARY CONFIGURED 
| ENTRIES (0) 



I 7 

I 10 

I 11 

I 12 

I 13 

I 14 

I 15 

I 16 

I 17 

I 20 

I 21 

I 22 
I 
I 



HERD OF IRPEDED QUEUE PCB RELATIVE INDEX |7 



TAIL OF IMPEDED QUEUE PCB RELATIVE INDEX |8 



NUM8ER OF CURRENTLY IMPEDED PROCESSES I 9 



NUMBER OF MAXIMUM IMPEDED PROCESSES 
(CURRENT) 



CUMULATIVE NUMBER OF IMPEDED PROCESSES 
(CURRENT) 



10 



12 
13 
14 



16 
17 



18 
19 



I20 

I 
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Proctss Tabltt 



Aisicned PCB Entry Fornat 



1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 
. -1 — | — | — | — | — | — | — | — | — | — I — I — I — I — I — I 

S IB |C |H |P |H |I |P |D |L IS IT |U |H |S |R 

R |F |R IS II IS IP IC IS |U |U |R IS |I IT |I 

OKI II II 10 IP IE I 10 I I IU IE IP 10 IT 

I |T |R IV |R |X | |F | I I 10 |R IV |B 

I I I |R II IP I IT | I I IQ II |A IK 



SLL RELATIVE ADDRESS OF PROCESS' SEGMENT 
LOCALITY LIST 



EXTRA DATA SEGMENT'S OST 



--■ 
A I I 
20 | 
B I 
-I- 
I 

3 V |SC| 

A I I 

.. j .. | 

M |R |R |M IB II |U |J IP IN IS IF |I IS |T |H 

4 |G |L |A |I |0 |C IN |A IS |0 |A |M |I |I |E 
| I I 10 I IP |K |U |G IN | |P |R in |M 



s 



OST ENTRY I FOR PROCESS* STACK 



FATHER'S PCB INDEX 



10 



11 



12 

13 

I 14 



SON'S PCB INDEX 



BROTHER'S PCB INOEX 



i i ens 

I 



■l-l-l-l- 

ID |F |S | 

IE |A IE j 

IA |C |R | 

I0 I IV | 

I IE I 

I— I— I— I— I- 

I IS I I 

I m lo j 




RESABORTINFO 
SUPTR 
DBXDSINFO 
STKINFO 

UAKEMASK 

FATHERINFO 

S0NINF0 

BROTHERINFO 



IPIINFO 



•l-l-l- 



UKUSEO 

I 

I 

l-M-l 

. I I I I I I I 

PTYPE |SI|HX|SK|ST|K9|CY|BK|PR0CSTATE 

I I I I I I I j 

l-l-l-l-l- -l~l 

IUSIEVENTFLAGS 

1 .-| 

SEGIDENTIFIER OF LAST REFERENCED I LASTREFCODESEGO 

SURPPABLE CODE SEGMENT j LASTREFC0DESEG1 



-I 1 !~l 

EVENT FLAGS 



I — I — I — I — I — I— I— I — 

D IL |C ID IE II IC |A | 



I IQ I 

15 S I | 

A I I 

I I 

-l-l« 



I I 

u 



IN |0 IS I 
IT |R |0 I 
IE IE IF | 
|R IR IT I 
■l-l-l-l- 



1 

I 



>«% 



PRIORITY 
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I 
IQUEUEINGINFO 

I 

I 

-I 



Process Tables 



Assigned PCB Entry fo mat fCent.) 






INOEX UITHIM CSTBLDCK TRBLE (CSTBLK) jPBXUQRONUn 

|f!RPDST 
I 
-I 
IPWPPIN 



LOGICAL SEGflENT TRRNSFQRH TABLE 
(LSTT) OST * 



RODRESS (PCB RELATIVE) TO PREVIOUS 
inPEDED PCB 



ADDRESS (PCB RELATIVE) TO MEXT 
IRPEDED PCB 



INIRPPIN 



""BREAKPOINT TRBLE RELATIVE ENTRY RODRESS IBPTUHK 



RDDR (PCB RED OF MEXT PROCESS 
IN SCHED QUEUE 



INQPTR 



RDDR (PCB RED OF PREV PROCESS 
IN SCKED QUEUE 



IPQPTR 



Process Tables 

PCB03.(0:1) STOVRALL FLAG - stack overflou is already allocated 

.(1:2) SC, set if executing systen code 

.(2:14) DST entry nunber of process' stack 



SRR - scheduling attention required 

Bounds Flag - Privilege node bounds check 

CRIT - process is critical or uith SIR 

HSIR - process has a sir 

PIOVR - pseudo interrupt happened uhen process had 
SIR or uas inpeded 

HSPRI - hold sir priority 

IPEXP - incore protect expired 

PC - pre-enpt capability 

OSOFT • Delayed soft int processing. A pending 

soft int cannot be processed because of sir 
or critical state. PSEUDOINT uill be invoked 
uhen these condition(s) go auay. 

LU - long wait 

SU - short uait 

TRU - ternwal read uait 

USEDQ - used a quantun since transaction began 

H1PRI - don't alter priority 

STOVA - process aborting due to stack overflou 

RITBK - Request Infomation Table Break 

(e.g., Message auaiting operator response) 

PCB01.(0:16) SLLPTR, SLL relative index to process' segnent 
locality list 

PCB02.(0:1) RD8, set if W pointing to an sbsoluts address 

.(2:14) XOS, DST entry nunber of extra data segnents to uhich 
D8 is set; zero if none. 



PCB0O.(O:1) 
.(1:1) 
.(2:1) 
.(3:1) 
.(4:1) 

.(5:1) 
.(6:1) 
.(7:1) 
.(8:1) 



.(9:1) 

.(10:1) 
.(11:1) 
.(12:1) 
.(13:1) 
.(14:1) 
.(15:1) 



0m^ 



PCB04.(0:1) 


n, nourning uait 


(1:1) 


RG, global RIN uait 


(2:1) 


RL, local RIN uait 


.(3:1) 


nA, nail uait 


.(4:1) 


BIO, blocked on I/O uait 


.(5:1) 


10, I/O uait 


.(6:1) 


UCP, UCOP uait and RIT uait 


.(7:1) 


JNK, junk uait 


.(8:1) 


Tin, tiner (pause) uait 


.(9:1) 


flSG, file systen basic IPC nessage uait 


.(10:1) 


SON, son uait 


.(11:1) 


FA, father uait 


.(12:1) 


MP, process uaiting to be umnpeded 


.(13:1) 


SIR, process uaiting for a sir 


.(14:1) 


Tin, process uaiting for a tine out (set up by 




systen to prevent a process hang due to a 




possible "lost" event) 


.(15:1) 


REH, process uaiting for nenory 


PCB05.(0:16) 


FPIN, father's PCB relative index 


PCBO6.(0:16) 


SPIN, son's PCB relative index 


PCB07.(0:16) 


BPIN, brother's PCB relative index 


| PCB10.(0:3) 


PSM, pseudo - interrupt node 




1: hard kill 




2: soft kill 




3: stop 




4: hibernate 




5: escape (Control-Y) 




6: break 




7: nornal 


.(3:1) 


USOFT, OK for soft interrupt to uake process 




even though it is uaiting on another event 


.(4:2) 


OA (origin of activate) 




0: other source 




1: father 




2: son 




3: reply done on RIT uait 


.(6:1) 


DEAD, set during expiration 


.(7:1) 


FAC, if set, the father is to be activated on process 




temination 


I .(8:1) 


SERVE, if set, this process is a OS SERVER proeess 
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Process Tables 



I PCB11.(0:1) 
.0:2) 



.(3:2) 



.(5:1) 
.(6:3) 



.(9:1) 

.(10:1) 
.(11:1) 
.(12:1) 
.(13:1) 
.(14:1) 
.05:1) 



LIVE, set if proeess is alive 
BnS, bloek nail, valid if M set 

0: sent to father 

1: received fron father 

2: send to son 

3: received son 
PPC, process to process communication, set uith 
respect to son 

0: null 

1: son to father 

2: father to son 

3: blocked 
STOV, abort - stack overflou has occurred 
PTYPE, procees type 

0: user 

1: user, son of nain 

2: user, nain 

3: user, nain, task 

4: systen 

5: 

6: systen, UCOP 

SI, set uhen the Dispatcher (and PSEUDOINT) 
should be aware of a pending toft interrupt 

HK, 

SK, 
ST 
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Process Tables 



PCB1S 



hard kill pseudo interrupt 
soft kill pseudo interrupt 
etop pseudo interrupt 
KB, hibernate pseudo interrupt 
CY, Control-Y peeudo interrupt 
BK, break pseudo interrupt 



PCB12.(0:15) EVENTFLAGS, one for each uait claee in PC804 
.(15:1) US, uake up uaiting suitch set if an auake is 

nissing (i.e., the event occurred before the process 
has a chance to uait for it) 

PCB13.(0:32) LASTREFSURPSEG, segnent identifier of laet 
referenced euappable code eegnent 



.(0:1) 
.(1:1) 
.(2:1) 
.(3:1) 
.(4:1) 
.(5:1) 
.(6:1) 
.(7:1) 



.(8:8) 
PCB16.(0:16) 
PCB17.(0:16) 

I PCB20.(0:16) 

| PCB21.(0:16) 

I PCB22.(0:16) 

I PCB24.(0:16) 

I PCB25.(0:16) 
I 



(QUEUING INFO) 
DISPQ - dispatcher's scheduling queue 
L scheduling class 
C scheduling class 
D scheduling class 
E scheduling class 
INTER -- process is interactive 
CORER - process is core resident 
RSOFT, Rllou soft interrupt (A value of 1 
inplies that user soft interrupts uill be 
processed. A zero value inhibits user soft 
ints (they »n queued). This bit is nanaged 
by FINTSTATE and F1NTEXIT intrinsic*. ) 
Process' scheduling priority 

P6X, CSTX block nap index of process' prog ran 

HAPDST, DST entry nunber of the CST napping 
table 

PII1PPM, PCB relative index of previous inpeded PIN 

NMPPIN, PCB relative index of next inpeded PIN 

BPTUKK, breakpoint table relative entry address 

NQPTR, PCB relative index of next proc in disp queue 

PQPTR,PCB relative index of prev proc in disp queue 
queue (* -1 if process is not alive) 
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Process Tablet 



Process Control Bl ack Extension (PCBX! Structure and Fori at 
Procett Central Block Exte nsion (PCBX) General Structure 



a— >l 

I- 



DL-a » SEC. BEL OL VALUE 



l\ 



DB-a * SEG> BEL D8 VALUE 



I 

I 

b — >| c-b * PXFIXED LENGTH 

f" 

I 

I- 



c— >| 



PXFIXED EXPANSION AREA 
BIT nAP 
(4 words) 



PXFIXED EXPANSION 



d-c * PXFILE LENGTH 



PXFILE 

EXPANSION/CONTRACTION 



> PXGL08 



I 
I 
> PXFIXED 



I 



I I 

I / 

-I / 
l\ 

-I \ 

I I 

I I 



CBX 

:ze 



> PXFILE 



I I 



d— >| COUNT OF SECTORS ALLOCATED I 

| FOB PXFIXED EXPANSION | 

I OL-c I 

i DL-b I 

I DL-a I 

, 1 

DL->| I 



I / 



DB~>| 
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Proem Tablta 



PXFIXED Rssiqnntnts 



The PXFIXED portion of tht PCBX contains tptcific infornation and control 
information. 



1 2 

l-l-l 



0| 



3 4 5 6 7 8 9 10 11 12 13 14 15 
-I — I — I — I — I — I — I — I — I — I — I — I — I 



C-B PXFIXED SIZE 



1 1 RELATIVE S(S-DB) 
| 

21 

I- 
31 

I- 



RELATIVE Z(Z-DB) 
DB to nORGUE't 0-4 



4 | INITIAL RELATIVE DL (DB-DL) 



51 



3 

4 Lfl HOST existed 
LP LOADPROCtd 

5 Trap nodes 
,AT(0:1)-Arith. 

IT(1:1)-Library 



CY(3:1)-Ctri-V 
XOS CNT |7 .CT(4:1)-Codt 

' U Utar UDC wist 



8 L Logging 
C Shan Clock 



GENERAL RESOURCE CAPABILITY 
j (FROH PROG-FILE) 

6!ATj"iT|SW|CT|"YY"| "liTlUC |G |R |LH|LP 6 .ST(2:1)-$ysttn' 
l-l-l-l- l-l-M-M-l-MH-l-l- "" ** ' ' " 

7| LINK TO XDS ENT'S IN EXP aria I 
M .., 1 — 

101 PI S| EXTRA DATA SEGflENT DST INDEX 

11| PI SI EXTRA DATA SEGflENT DST INDEX 

121 P| S| EXTRA DATA SEGflENT DST INDEX 

131 PI SI EXTRA DATA SEGflENT DST INDEX 

I 14|*X| A| ABORT Y |RU| INITIAL CST INDEX 

MSI nAxinun stack size (haxoata ann) 
I 



161 ARXTHflETIC TRAP ENABLE flASK 

ARITHMETIC TRAP P LABEL 



I 

I 17! 

I I- 

I 20I 

I- 

21 1 

I- 

221 



LIBRARY TRAP P LABEL 
SrSTEn TRAP PLABEL 



I — 



CONTROL Y PLABEL 



9 G Global RIN acquired 
A Acct UDC witt 

10 / 0:1 RESERVED FOX 
| CST EXPANSION 
| 1:1 • 1 IF ABORT 
I IN PROGRESS 
< 7:1 • IF HAVE 
I R/U ACCESS 
| TO PROG FILE 
| > 1 OTHERUISE 
I 8:8 • CST A OF SEG 



11 
12 



13 



14 
15 



INITIALLY 
EXECUTED AT 
AT PROC- 
CRERTIOX 



IS 



NOTE: The General Resource Capability (lord (X5) in tht PXFIXEO 
area is used by HP Buaintst Basic. Plcatt inforn thtn 
uhen naking any changes to it or to its' location. 
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Process Tablet 



PXGtfB Forwat 

Tht PXGLOB portion of tht pebx is for job infornation, and contains tht sant 
job rtlattd infornation for ail proctssts btlonging to tht sant job. 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I-I-I-I-I--I--I-I-I--I-I-I-I-I--I--I * 

__ -— ..... ~ .. 

1 



2| USER ATTRIBUTES (Ste JIT's UCAP uord) 



3 



10 



12 
13 



EXPAND TO DISPLACEflENT FROfl PCBX TO DL 



EXPAND TO DISPLACEflENT FROfl PCBX TO DB 1 



JflAT INOEX 



JPCNT INDEX 



jt^^lh. 



4 



6 SBI 



JCUT INDEX 
l-l l-l-l-l-l-l-l 1 

R| TY | Dl IIGAI | | | STACK OUflP FLAGSI6 

,.., M .. M ~|-.|"I j 

| NATIVE LANGUAGE 1 7 



-I- 



ACTUAL JOB INPUT LDEV 



ACTUAL JOB OUTPUT LDEV 



JDT DST INDEX 



JIT DST INDEX 



-I 

18 
-I 

19 
-I 

MO 
-I 

Ml 



Stack Dunp Flags 

Bit 10 « Arntd 

Bit 11 * Suppress tractback 

Bit 12 « Suppress ASCII 

Bit 13 * 0-63 to S 

Bit 14 * QINIT to S 

Bit 15 « OL to QINIT 



R * restart bit 
I « job in/list inttractivt 
D "job in/litt duplicative 
TY « job typt 

« undefined 

1 > ttation 

2 ■ job 

3 • taak 

* « rtstrvtd: 

SB ■ stun bit ; used for ttack underflow emulation for ICF44 or ICF55. 

GA ■ Global Allow bit 
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Process Tabltt 

PXFIXED Atsjqnntntt (Cent.) 



23 
24 
25 

26 
27 

30 

31 
32 
33 
34 
35 
36 

37 

40 
41 
42| 



43I 

I- 
44| 

I- 
45I 



CODE TRAP PLABEL 



DATA COflfl TERfllNATION TRAP PLABEL 



IflAGE TRAP PLABEL 



RESERVED 



CURRENT RAX STACK SIZE 

(LARGEST VALUE EVER FOR Z-DL) 



PROCESS ELAPSED CPU TII1E 
(tlSEC) 



nAXIRUfl DATA SEG SIZE USED(IN SECTORS) 
TOTAL VIRTUAL STORAGE USED(IN SECTORS) 



CURRENT EXTRA DATA SEGflENT SPACE 
flAXIflUfl EXTRA DATA SEGflENT SPACE 



-I- 



PRIV flODE I STOV COUNT 

BOUNDS FLAGS I 



PROCESS EXECUTION TlflE REMINDER 
(IN flSEC) 



21 
22 
23 

24 
25 

26 
27 
28 
129 
30 

31 



SET TO-1 UHEN IN BREAK flODE * 



CONTINUE FLAG (: CONTINUE COflflRwO) *» 



ACTUAL SIZE OF VIRTUAL SPACE 
ALLOCATED TO STACK 



EAROR LEVEL 



INTRINSIC ERRORS 



| 



INTRINSIC EP e QRS 



46| 

l~ 
47| 

I- 
S0| 



INTRINSIC ERRORS 



| 



511 



INTRINSIC ERRORS 
INTRINSIC ERRORS 
INTRINSIC ERRORS 



32 
33 



136 



139 

1 40 

141 
| 
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Proem Ttbltt 



/"^N 



PXFIXED ft«t igwn»nti I Cont. ) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

52 1 TSLR, VIRTUAL TME SINCE LUST |42 

| RESCHEDULED _ 

53! TSTB""viRTUflL TWE SINCE TRRNSACTION |43 

| BEGAN „„„.....! 

54 1 TKuSlN7viRTURL TME SINCE SURPIN |44 

55! TSLfl""viRTURL TME SINCE LAST RBSEHCE |45 

1 1 

56 I TSLD, VIRTUAL TIRE SINCE LAST |46 

| DEALLOCATION I 

1 1 

57 I QCNT. ft TIRES TRANSACTION EXCEEDED |47 

| THE AST I 

eOMoT"|o"l RESERVEO FOR FUTURE SOFT |48 

C I IS I INT USE I 

I IV I II I _ j 

611 TRLXINDEXFOR KERNEL TMEOUT PROCEDURE |49 

l-l ! JOB TYPE 



62 
63 
64 
65 
66 
67 
701 
71 
72I 



TV | JOB/SESSION NUflBER 
-I- 



RESOURCE COUNT 



PROCESS ELAPSED CPU TIHE (rtSEC) SINCE LAST 
CHCROUP COnnRND. USED BY CI'S ONLY. 



RESERVED FOR FUTURE USE 



RESERVED FOR FUTURE USE 
—l—l— I— I 

ICYI |SI| 
I--I--M- 



TWEOUT TRLX 



150 1 * SESSION 

2 » JOB 
51 

52 

53 
54 
55 
56 
57 
58 
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Proctts Tablet 



OSI Statt of tht "USOFT" PCB bit uhtn ccntroi-y 
trap uat tnttrtd. USOFT * 1 alloua user toft 
inttrruptt againat tht p roc tit. It it ttt to 
zero uhtn tht ecntrol-y handltr it entered. 
It it ttt to itt prior ttatt uhtn tht uttr 
callt RESETCONTROL 

* Stt to eoroiand rtcord ltngth uhtn connand ptnding 
(i.t., connand tnttrtd during brtah or tncounttred 
during flushing). 

** CONTINUE FLAG Valutt 

» No CONTINUE in tf ftct 

1 « CONTINUE jutt tncounttrtd 

2 « CONTINUE in tfftct for thit cowitnd 



CYFLAG 

PC8XFIXED(56).(1:1) 



SI FLAG 

PCBXFIXED(56).(3:1) 



* Stt by PSEUDOINT uhtn thtrt it a ptnding 
control-y uhich cannot bt precttstd because 
of tytttn codt or priviltgtd codt. ININ 
chtckt thit bit on bound* violation or 
tract trap. 



« Sptcifitt tht ttate of tht uttr interrupt 
flag uhtn tht current control-y uat processed. 



PRIV RODE BOUNDS FLAGS: j 

BITS 0-1 « if DB, Q and S boundt checking it disabled 

■ 1 if DB bounds checking it disabled uith Q and S bounds 

checking enabled 
• 2 if DB bounds checking is enabled uith Q and S bounds 

checking disabled 
« 3 if DB, and S bounds checking enabled 

IFWffl: Filt nunbtr fron intrintic TRACE 

ERROR ON CNT: Nunbtr tint though error on 

V « V/Plut trantaction tract (1«0N; 0«OFF) 

E * Tracing Enablt (1 'Enable; O'Diatblt) 
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Proctts Tables 



PXFIXED Assionnenta (Cont.) 

111111 
0123456789012345 
,V-I~I--I--I--I--I--I--M--I--I--M--I 



PCLASShRSK 



731 

I- 
'41 



'5| PROCOUESTOPUORO 
I 

761 

I PROCSTOPTME 
77| 

1001 PC CENTRAL TERniNATION DST 
I j 



I 

I 1011 

i I 

I 1021 



IFNUn 



ERROR ON CNT I V/E 
1 



I 1031 
I- 



I- PROC PREEHPT TIHE 



I 104| 



159 
60 
61 

62 
63 
64 
65 
66 
67 
68 



I 1171 
I- 



| PXFIXED EXPANSION BITI1AP 



179 



NOTES: P s 1 if opened by priv user 

S » 1 if data segnent is sharable 

PCLASSHRSK * Bit nask of classes this process has enabled 
PROCOUESTOPUORO. (0:4) ■ PROCESS PRIORITY: 7 « L queue 

6 « C queue 
2 a D queue 
1 » E queue 
.(4:12) * REASON STOPPED: 1 * ttop ttg fault 

2 * ttop disc uait 

3 " blocktd I/O, non-terninal 

4 * tirninal read 

5 * ttop inptdt 

6 * ttop activt 
PROCSTOPTWE « DBL uord tintttanp of uhtn procttt ttopptd for 

rtaton given in PROCQUESTOPUORD 



DCY 



A delayed Control-Y it ptnding (thit bit 
it chtcktd by ININ on boundt violation to 
dttermne if it got: 1) true boundt violation 
or 2) an induced bounds violation that 
indicattd that tht Control-Y trap proctdurt 
nay nou bt tnttrtd). 
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Proctts Tabltt 



PXFIXED Expansion Bitnao 



Tht PXFIXED bitnap and txpantion area it for use in accounting of extra 
data segnents acquired by the procttt. 

File Svsten Section of PCBX (PXFILE) 



It it a contiguous txpandablt 
and contractiblt block of ttoragt that it nanaged by tht filt tytttn 



The PXFILE area it a tubttction of tht PCBX. 



prinarily for itt oun utt. Other subsystem, nantly CS and OS, alto nafct 
use of the PXFILE ttction. In doing to thty mitt eonforn to tht 
conventiont of tht filt tytttn. 

Tht ovtrall ttructurt of tht PXFILE arte it: 



OVERHERO 



CONTROL BLOCK 
TABLE 



AVAILABLE 



ACTIVE FILE 
TABLE 



(FIXED) 
(VARIABLE) 

(VRRIRBLE) 

(VARIABLE) 
DL-5 
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Proem Tables 

Overhead 

Tht part labeled Overhead contains nation that pertains to the • section. It 

infona addreettd via th« pointtr at OL-3. 

tntir 



I 



111111 
0123456789012345 
l~l--M--M--M--IH--i--l--IH--IH~l 
0| PXFILE SIZE IN UOROS PXFSIZE 

| 1 

1 1 LAST OOPEH ERROR N I LAST COPEN ERROR • 1 



2IN I 

3 

4 



LAST DS AFT 



SLAVE AFT NUHBER 



LAST KOPEN ERROR • I LAST FOPEN ERROR • 



AFT SIZE IN UOROS 



CS TRACE FILE INFO 
LAST RESPONDING NO-UAIT I/O RFT ENTRY • 



1ST USER (NOBUF) CONTROL BLOCK TABLE DST • 



2ND USER (NOBUF) CONTROL BLOCK TABLE DST i 



3RD USER (NOBUF) CONTROL BLOCK TABLE DST N 



4TH USER (NOBUF) CONTROL BLOCK TABLE DST M 



5TH USER (NOBUF) CONTROL BLOCK TABLE DST • 



6TH USER (NOBUF) CONTROL BLOCK TABLE DST N 



7TH USER (NOBUF) CONTROL BLOCK TABLE DST • 



8TH USER (N08UF) CONTROL BLOCK TABLE DST • 



6 


PXAFTSIZE 


7 
8 


(PXCTRINFO) 


9 


PXFLfFTOFF 


10 


PXFCBT1 


11 


(PXFCBT2) 


12 


(PXFCBT3) 


13 


(PXFCBT4) 


14 


(PXFCBT5) 


15 


(PXFCBT6) 


16 


(PXFCBT7) 


17 


(PXFCBT8) 



Partial uord field idtntifiirt art: 



PXFDOPEN 
PXFCOPEN 
PXFNOCB 
PXFKOPEN 
PXFFOPEN 



■ PXFILE(1).(0:8)i, 
» PXFILE(1).(8:8)i, 
« PXFILE(2).(0:1)#, 
« PXFILE(5).(0:8)i, 
« PXFILE(S).(8:8)i, 



last DOPEN trror codt 
laot COPEN error codt 
no CBt in PXFILE CBT? 
latt KOPEN trror codt 
last FOPEN trror codt 
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Preetto Tabltt 



PXFILE Control Block Tablt (PXFCBT) 



Addressing uithin a PXFILE control block tablt it tontuhat mrt conplicated 
than addressing an extra data •egntnt CBT tinea tht tablt does not btgin at 
DB«0. At a rttult all pointer* uithin tht table art tablt rtlativt; tht 
ttarting addrttt of tht table nutt bt added to a pointer to generate a final 
DB-rtlat&ve addrttt. Thit addrttting convention it eontittently applied to 
all control block tablet. 

Uhen tht control block tablt it expanded, apact it taken f ron the AVAILABLE 
area. If no apace it available then tht PXFILE arte it expanded and tht 
acquired apace it added to the AVAILABLE arte. 

Tht part labtltd Availablt it uttd to providt space uhen the Control Block 
Table or the Active File Table it expanded. Thece tuo tablet grou touardt 
each other, and uhen nore apace it needed it it tinply taken f ron the 
Available Block. 

Uhen the Available area it exhaueted, the PXFILE trtt it expanded, the RFT it 
relocated and the neu apace it added to the Available Block. 

Currently tht PXFILE arte it only expanded; it ia never contracted. For nore 
infornetion refer to Chapter 6, "File Sytten", and aee the Retive File Table. 



Preceat Tablet 

Ditcuttion: 
PXFRFTSIZE 

PXFCBT1-8 

PXFCOPEN 

PXFCTRINFO 

PXFDOPEN 

PXFDSINFO 
PXFFOPEN 



Thit it the aiie (in uordt) of tht Retive File Table (RFT). 
The size it in uordt to einplify calculating the tin of 
the available block. 

Thete art the DST mmbtrt of the uter (NOBUF) control block 
tablet. A OST nunber of indicates that no data tegntnt 
it allocated. 

Thia contains the latt COPEN trror nunber. Not uted by the 
file sytten. 

This contains infornation pertinent to the CS trace file. 
Not uted by the file aysten. 

This contains the last DOPEN error nunber. Not used by the 
file sytten. 



Reterved for I 



Not used by the file sytten. 



PXFLEFTOFF 



PXFNOCB 



PXFSIZE 



Thit contains tht last FOPEN trror nunber. If it is zero 
then the last FOPEN succeaifully conpleted; otheruite the 
last FOPEN uas unsuccessful and the nunber is the file 
systen trror nunber. 

This contains the last KOPEN trror nunber. KSRfl it partly 
enbedded in the file systen, and an FOPEN failure on a KSAJ1 
file can be caused by a failure to open either the key file 
or tht data file. This trror nunber is used in conjunction 
uith PXFFOPEN to deternine uhich file cauaed the KSAtl open 
failure. Thia error nunber is not used by the file systen. 

This is the RFT entry nunber of the last file/line that 
conpleted a nouait I/O; if zero then no nouait I/O has been 
conpleted. Thit ctll it naintaintd tolely by and for the 
IOUAIT intrintic. 

Thit bit tignifitt that control blockt are not to be 
created in the PXFILE control block table. Thit bit it tet 
by the NOCB paraneter to the CREATE intrintic or the :RUN 
connand. Thit feature pernita tht uttr to have at nuch 
etack space aa pottible; otheruitt tht file tytttn uill 
take aeveral hundred uorde of ttack for tht PXFILE eontrol 
block tablt. 

Thit it the tize (in uordt) of the conplete PXFILE area. 
It is the sun of the overhead block, the control block 
table, the active file table and the available block. 
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Process Tables 



PCBX For Core Resident Sveten Proceaa Stacke 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

|.. MH ~|~|--l--l--IH--IH~!~l-IH--j \ 

0| DISP FROd PCBX TO DL |0 \ 

| 1 | 

11 DISP FROH PCBX TO DB M I 

| 1 | 

21 USER RTTRIBUTES (RLUflYS -1) |2 I 

| 1 | 

3 !3 
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4 
5 

6 
7 

10 
11 
12 
13 
12 
13 
14 
15 
16 
17 
20 

21 

I 
?2| 

I 
2? I 

I 
2<l 




M -|- 

| D| II 
MH~ 





ACTUAL JOB INPUT LDEV 


ACTUAL JOB OUTPUT LDEV 








PXFIXEO SIZE (c-b) 


RELATIVE S (S-DB) 


RELATIVE Z (Z-D8) 


INITIAL Q (Q-DB) 



RELPTIVE DL (D8-DL) 

GENERAL RESOURCE CAPABILITY (-1) 

RESERVED 



DL-c 

DL-b 



> PXGL08 



4 



11 / 

/ 

|10\ 

\ 

11 I 
I 

12 I 
I 

13 I 
I 

14 > PXFIXEO 



DL-a 



M9 
-I 

120/ 
-1 / 



«OUS: 1. r *er« is *o PXFIiE area. 

2. The 'XFIXEfc area i? "jch snaller than a nornal PCBX 



G.23.00 
7- 20 



^\ 



-k*%. 



**) 



Process Tablet 



Process To Process Commu nication Table 

This table it used at the eennunication link by uhich father and ton 
processes connunicate with one another via the nailboK tchene. Thit table 
eontamt tuo uordt per entry and xt indexed by PCBN (entry index it 
ntaninglett). Each tuo uord entry of index N ettentially relatet uhere, at 
uell as hou nuch, nail nay be found for a procett N uith retpect to 
communications betueen M and hit father process. 



Procett Tablet 



Subsvsten Reserved PL Hrea 



REMIXING DL AREA 



Entry Format 



| , 

uord 0| UORO COUNT | 

uord 1 | RAIL UORO OR DSTi | 
, , 

Uhere uord * the * of nail uordt to 
be trantferred. 
uord 1 * the only uord of nail 
itaelf if uord a 1 

otheruite 
it contains the DSTN of 
the extra data segnent 
uhere "uord count" uords 
of nail exist. 



NOTE: Rssune procett S it the ton of procett F. Then the process to process 
communication table index uhich uill be used for nailbox connumcation 
betueen son S and father F uill be that of the son (i.e., S). 
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Process Tables 



FORTRRN Logical Unit Table (FLUT) 



The tegnenter it responsible for the preparation and initialization of a 
FORTRRN logical unit table. Thit it done uhen a progran it prepared if that 
progran contains at leatt one progran unit that referencet a logical unit. 
The location of the FLUT it in the tecondary 08 area and the address of this 
location it contained in D8-1. 

The FLUT it fomatted at per the following exanple: 



OB-1 2 


RESERVED FOR SORT / RERGE 
.................................. — — — — 


DB-11 


RESERVED FOR TRACE, TOOLBOX, 
AND BUSINESS BASIC 


08-10 


.. „„...__._........._._. - ..... — 

EXTERNAL PLABEL OF OUTER BLOCK 


08-7 
08-6 


RESERVED FOR TRACE AND SYABOLIC DEBUG 


DB AODRESS OF STLT 


OB-S 


............................................... 

RESERVED FOR COBOL 


DB-4 


......................... .................... 

RESERVED FOR COBOL 


DB-3 


RESERVED FOR COBOL 


DB-2 


RESERVED FOR FORRATTER AND PASCAL 
............................................... 


OB-1 


DB ADDRESS OF FLUT 



IOB-10 

I 

IDB-9 



ID8-7 

I 

IDB-6 

I 

IDB-5 

I 

I DB-4 

I 

I DB-3 

I 

I DB-2 

I 

I OB-1 

I 

I 



08 AREA 
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I- 
D8-1I 



I- 



I— I— I 
DB+X| 3 I | 
I — I — I 
I 4 | | 
I — I — I 
I 5 I I 
I — I — I 
I 7 | | 
I — I — I 
HO I | 
I — I — I 
12551 I 

/ 1 I — 

I 
1st BYTE 
List of the logical unit nunbers 
referred to in this FORTRAN- 
p reduced progran. 
(255 terninates). 



I 

2nd 8YTE 
The APE file nunber (as returned 
by FOPEN) used in accessing the 
file. Zero if file not open. 
Filled in by formatter as each 
logical unit is initially 
referenced. 



Job Tables 

CHAPTER 8 MJAlLEj 

Job Tablet Qvcrvicu 

Job Ratter Table (JRAT): One entry per job /sets ion. Contains information 
needed to get the job/session running. Entry it created at the introduction 
of job/session. 

Job Information Table (JIT): One OST per job/session. Contains infomation 
needed by the job/tettion at it it executing. 

Procett Job Crott Reference Table (PJXREF): One DST per tytten. Used to 
determine the job/tettion nam procett (Connand Interpreter) for any process 
on the tytten. 

Job Procett Count Table (JPCNT): One entry per job/session. Entry nunber 
used to index into the JIR to lock job rctourcet. 

Job Directory Table (JOT): One DST per job/tettion. Containa the following 
tub-tablet uted by detcendantt of job/tettion. Rutt obtain JIR (by using 
JPCNT index) before accosting JDT. Sub-tablet: 

1. Data Segnent Directory - Directory of tharablc OSTs used by job/session 

2. Tenporary File Directory 

3. File Equation Table 

4. Line Equation Table 

5. Job Control Uord Table 

Job Cut-off Table (JCUT): Stores total CPU tine Unit of job/session and 
aecunulatee the CPU tine that job/eeseion usee. 

UCOP Requeet Queue: A queue of Process Identification Nunbers that arc 
terminating. 
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Jab flatter Tablt (JflRT) Structurt 



Job Tablet 



SIR « 15 » 117 
OST « 25 * 231 



012345678 910 12345 
H-H-l-M-H-M-H-M-H 
0( HRXSIZE I CURSI2E |0 

1| MOUNT I ENTRY |1 
INFO I SIZE 



ENTRY POINTER 



URITING QUEUE KERO POINTER 



UfilTIHG QUEUE TRIL POINTER 
•|- 



TY| 



2 

3 

4 

5 

6 

7 

10 

11 

12 

131 

I 

14| JLMIT 
I 

15| JNUn 



SCOUNTER 



NOT USED 



JCOUNTER 



TY| 

NOT USED 
-I— l-l-l 1 1 

USECISIJI ISFENCE IJOBFNCE 9 
-I— l-l-l 1 1 

sunn 



SNun 



l- 



ENTRY 

I 
I 

I 



mm JHRT tizt (uordt/128) 
currant JflflT tizt (uordt/128) 
tVHOUNT ttatt tavtd For 

URRnSTRRTt; JHRT tntry 

tizt (Z46) 

DB point! r to Firtt tntry (Z46) 

DB-rtlatiwt pointtr to tntry 
at tht head oF tht UfllUng Int. 
DB-relative pointtr to tntry 
at tht tail oF tht URITing Int. 
Next attignablt ttttion N, TY«1 
Uordt 6&7 art a doublt For 
HPE X/L conpatibiiity. Only 
tht LSU it uttd in RPE V/E. 
Ntxt attignablt batch i, TY«2 



L«1, logoff in progrttt 
S/J«1 : S/J tt dup chtck arntd 
SEC=0,high;«3,lou JOBSECURITY 
naxinun nunbtr ttttient C E 

\ U N 
currtnt nunbtr ttttiont I R E 

| RC 
naxinun • batch jobs 



currtnt N batch jobt 



161 JHRT SCHEDHERD 
| 



I 14 DB pointtr to htad of 
| scheduled job queue 



> E U 

I NT 

I T I 

/ LN 

Y G 
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Job Tabltt 



Job Hatttr Tablt (JHRT) Ent ry 



111111 
0123456789012345 
H-H-H-H-l-H-H-l-H- 
0| STATE |D|I|0|R|U|C| INPRI 

,..-i i-i-i-i-i-i-i : 

JOB/SESSION NUMER |1 



I 2 

3 
4 
5 
6 

7| 
10 
11 
12 

13 
14 
15 
16 

17 
20 
21 
22 

23 

24 

25 

26 
27 

I 

I » 

I 
31 



TY| 
-I- 



NOT USED 



USER I 



ACCOUNT NRI1E 



J08NRItE 



GROUP LOGON NRnE 



JIN DEVICE 



2 

3 
4 
5 
6 

7 
8 
9 
10 

11 

12 
13 
14 

15 
16 
17 
18 
-I 
1 19 

20 



JUST DEVICE 

JUURN DATE (CfllfcNORR) 21 



Tint (CLOCK) 
-I" 



LRNGURGE I 



HfllH PIN 



ttatt 

« Frtt tntry 

1 « introduced, in 

STRRTDEVICE 
Z70 » tchtdultd in tchtdultd 

job queue 
Z40 * waiting, job in 

tchtduling queue 
Z60 • initial, UCOP 

hat crtattd JSdP 

2 « txtcutmg, JSRP 
Firithtd initial. 

3 > ttrninating. 

4 » tutptndtd. 
D * duplicative 
I « inttractivt 
G * group paeeuord 
(QUIET node, if ttatt * 2) 
R a account pattuord 
U * uttr pattuord 

* pattuord validated 
(STRRTDEVICE) 

1 ■ nutt validate pattuord 
(INITJSRP) 

R * reetrvtd 
C • J LIST it dtvict 
clatt indtx 



|?2 
23 



32 CPU LWIT 126 
l-l-l— I 1- I , 

33 S|R IN I FT IOUTPRI I NUnCOPItS 127 
|-|-|~l 1 j 

ORIGJIN 128 

1 

j 35) ORIGJUST 1 29 



ty ■ 1 - ttttion 

2 - job 



» dtfault, -1 • no linit 

ORIGJIK/QRIGJLXST it 
uttd as a tchrdulir.g 
link by UCOP « w e« ftatt» 
Z40 or 170. D8 -cla'ive ptr. 
L.bt entry in iitt contact 
ztro (0). 
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Job Tabltt 



Jab flatter Ta ^» nm) Structure (Cont.) 



171 

I 

201 



UORKRRER 

(23 UORDS) 



|15 SFENCE it ttttion Fence 

l« • 



451 

I- 
461 



137 
-I 
138 



1131 



175 



URITING SESSIONS 

FIFO uithin HIPRI/INPUT priority 
[ERROR JOBS ] 

I FIFO j 

URITING JOBS 

FIFO uithin HIPRI/INPUT priority 



I (ENTRY 0) 

I 



I 

I (ENTRY 1) 

I 



I 

I (ENTRY 1) 

I 



I 

| (LAST ENTRY) 
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Job Tabltt 



Job Hatttr Tth l* (JNAn Entry fCent.) 



I 36| 



-l-l-h 
37|P|U|N| 



40 
41 

43 
44 
45 



JHRT CRERTOR PIN 



DRTE OF LAST CHGROUP 
TIRE OF LAST CHGROUP 



RESERVED 



UNUSED 



UNUSED 
l-l-H-H-H-l-H-H-H 
0123456789012345 
111111 



30 



32 
33 
34 
35 

36 
37 



Uttd uith tht progrannatic 

creation oF atttiont/tcheduled 

jobt. 

P « Progrannatic logon 

U « URITTILLON 

N ■ NOURIT 



R ■ RESTART 

N - SEQUENCEO 

S • ORIGJIN it epooltd. 



FT ■ funny ttrninal 

00 - regular tern. 

01 - regular torn., 

tptcial logon 

10 - RPL ttrn. 

11 - RPL tern. 



^) 
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Job Tablet 



Job Steteo 



JOB STATES - JflAT ENTRY UORO 0.(0:6) 

SHOUJOB - Displays job states by scanning JnflT OST (231) 

LOGON uses all statu except "SUSPEND" 



STATE 
NO. 



-I- 



| STATE 
| NAflE 



-I- 



1 | INTRO 
I 

I 



-I" 

| PROCESS 
I 
-I- 



SCHEO 



I UAIT 



I OEVREC 
I JSnP 
i SPOOLER 
-I- 



I 1- 

I SEGAENT | 

I I 

-I- 



PROCEDURE(S) 



NURSERY | 
I I 

I I 



Z60 



I INIT- 
I IAUZAT- 
I ION 
-I- 



I UCOP 

I 

I OEVREC 

I jshp 

I 

I SPOOLER 
-I- 



-I- 



-I- 



STARTDEVICE - PUTJHAT | 
- ALLOCENTRY IN SEGflENT | 
RLLOCUTIL I 



IJOBSCKEO i 
I I 

I NURSERY | 
l\ I 
I SPOOLINGI 
1/ I 



CXSTSTRERI1 I 
SCHEDULEOSCHED I 
1 

STRRTDEVICE - SCKEDULEJOB I 

1 

SPOOLSTUFFIN ->SCHEDULEJOB | 



I UCOP 
I 

I 



-I- 



I EXEC 

| TERMN- 

I ATING 

-I 

I FREE 
I ENTRY 
I 
-I- 



-I- 






| SUSP 



I Jsnp 

I jsbp 
I 

I jshp 

I 

I 

I Jsnp 



I UCOP I 

I I 

I I 

-I 1- 

I NURSERY | 
-I 1- 

i nORGUE | 

I I 

-I 1- 

I ITORGUE I 

I I 

i I 

-I 1- 

I OPLOU | 
-I 1- 






LRUNCHJOB 



I 



INITJSRP I 

TERMNATE - EXPIRE - I 

CLEANUPJOB I 

TERMNATE - EXPIRE - I 

CLEANUPJOB - OEALLOCENTRY | 

IN RLLOCUTIL I 

CX8RERKJ0B 1 



For states INTRO and UAIT, 



jm\ 



OEVREC » logon connand originated on ttrninal or 
other unspooled device. 

SPOOLER * logon connand originated on spooled device. 

JSnP a logon connand is the result of the execution of 
a :STRERH connand. (This also includes USER 
processes uhich have done progrannatic :STRERfls.) 
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Process Job Cross Referen ce Table (PJXREF) 



DST ' 162 
TRBLESIZE * « PC8 entries ♦ 1 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

,..,..|..|-I~I--I--I--I--I--I--I--I--IH--I--I 

fll NUtlBER OF ENTRIES I 

, j 

1 1 J/S NUflBER OF PIN 1 I 

| j 

2 1 J/S NUflBER OF PIN 2 I 

| 1 

| j 

n| J/S NUflBER OF PIN n I 

, 1 

n ♦ 1 | J/S NUflBER OF PIN n ♦ 1 | 

This table is only used by the SNOUQ connand. The entries in the table are 
set up through PROCREATE and nodified by nORGUE. 

The job/session nunber is in the fornat: 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

| — —| ... 1 00 » Unused/undefined 

jj | 01 * Session 

| 1 1 10 - Job 

11 « Unused/undefined 
Bit 2-15 * Joo/Scssion Nunber 

A conpletely zero entry is either fron a systen process or a currently unused 
pin. 
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Job Process Countable (JPCNT) 



(1 Bit Entry / Running , 



nEflORY RESIDENT 



11111 
0123456789012345 
M-H-l-M-H-M-l-H-M- 
0| TOTAL CONFIGURED NUflBER OF 
I JOBS AND SESSIONS 



SYSGL08 BASE > DB*13(Z15) 
OST - 24 (Z30) 
SIR « 13 (Z15) 



11 



TOTAL NUflBER OF FREE 
ENTRIES 



BIT flRP RELATIVE INDEX OF 
UORO CONTAINING NEXT 
FREE ENTRY 



3 UNUSED 



BIT I 



free entry ■ 1 
allocated entry • 



flAXIflUfl 64 UORDS LONG 



A JPCNT entry nust be allocated before the nain process can be procreated. 
The JPCNT Index is located in uord 4, PXGLOBAL area, of the stack of a job or 
session. One JPCNT Index is allocated per job or session. 

The job SIR (JIR) * base ♦ JPCNT index, where bass is the nunber of eyeten 
reserved SIRs. The JIR is used to lock the Job Directory Table. 

NCTE: This table is conpletely bit oriented with each entry consisting of 
one bit. Entries *rt taken fron available pool on a "first found" 
basis. A "1" found in the bit nap indicates a free entry. A zero (0) 
found in the bit nap indicates an allocated entry. Uord 2 of this 
table is the index of the uord in the Bit flap uhere the next free 
entry resides. At systen start up, this uord is set to zero (0). The 
Bit r.«p can be thought of as ranging fron 0-63 (64 total uords - 1024 
entries). 



Job Tables 



Job Cutoff Table (JCUT) 
1 Entry / CPU-limted Job 



flEBORY RODENT 

SYSGLOB BASE * DB*11(Z13) 
DST=36 (Z44);SIR'14 (Z16) 
SYSGLOB ♦ Z117 « default 
CPU tine iimt for jobs 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

1 — I — I — I — I — I — I — I — 1 — I --I — I — I — I — I — I — I \ 
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I — 

/ 1 

I— 
/-I 
I" 
I 

I- 
I 



« OF REAL ENTRIES 
ENTRY SIZE (3) 



10 I 
-I I 



M I 



FREE HERD 

POINTER TO LAST ENTRY (0) 



-I 



UNUSED 
UNUSED 



12 
— -I I 
13 I 

— "I 



I HEADER 
ENTRIES 
(2) 






I 

|4 I 

-I I 

IS I 

— I / 




* 1VPICRL ENTRY 

I > TlflE LIMT 
I | (SECONDS) 



TlflE COUNT 
(flSEC) 



V> 



I 
I \ 

POINTER TO NEXT FREE ENTRY | | 

(END OF LIST * 0) || 

1 I 

I > FREE ENTRY 
1 , 

I I 
, / 

LAST ENTRY | 
, 

I 
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Job Information Table (JIT) 
JIT OST it wort 11 (bate 10) in PXCUOB 



111111 

0123456789012345 

H-H-l-H-l-H-H-H-M- 

0| JIT OST 

1| 6 I MOT USEO 

2|" POINTER TO JOB INFO (Z7) 

31 POINTER TO flCCT INFO (Z60) 3 

4| POINTER TO RESERVED (Z73) 4 
| AREA 

I- 




1 
2 * Ray bt Z10 for Sytttn Processes 



5 1 flSSOCIRTIOH TABLE INDEX 5 



I- 
6| 
,...| 

7|TY | JOB NUHBER 

I — I 
101 
I 

111 
I 1 — I* 

121 JITI1AXP | EOF | 



-I- 

IF 6 

-I- 

17 

s 



I— 



I 131 
I 



JITItPN 



-I — I- 



| 

I 141 OS ORTRSEG 
I I 

151 JITRSEC 



I- 
161 JITCSEC (2 UOROS) 

| GROUP SECURITY 

I- 
201 

I 

I- 
24| JITHON (4 UOROS) 

i HOHE CROUP 



JITHRN (4 UOROS) 
ACCOUNT NAP.E 



I- 



XI JITLGN (4 UOROS) 
| LOGON GROUP 

l-l-H-l-H-l-H-H-H-H 
0123456789012345 
111111 



9 

10 

11 

12 

13 

14 

16 

20 

24 



F - Job/Scssion-uids 
FPRAP option flag 
(JSFPHAP) 

TY - 1 » Session 
2 « Job 



JITAAXP - AAXJOBPRI capability 

JITflPN - Job nam PIN. 

JITEOF - used by F CLOSE to tell 
CI that a ISTOIN/X file uas 
closed u/out encountering an 
EOF. (8:1)«ISTDIN,(9:1)«ISTDINX 

JITRSEC * Recount Security 
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Job Tables 



Job Tables 



Job Information Table (JIT) (Cent.) 



111111 
0123456789012345 



621 
631 



651 
66 

67 
70 

71 

72 

73 



•l-l-l-l-l-l-H-l-H-H-H- 

3 48 

JITCREC - « OF CREATIONS 49 



JITCPUC 

CPU MLUSECONOS 



-I- 



50 

51 



NOT USED I HIPRI 52 HIPRI - highest job priority 



-I- 
JITAIP 



JITGIP 





JITGIP 



I 

| nVTRBX 



-I- 



75 1 
76 1 
77 1 
1001 
101| 
1021 



ALLOU nASK ** 



Recounting Information 



153 

54 Index Pointer 

55 Group Index Pointer 

56 Systcn Volune Set 

157 RVTABX - taunted Volume 

-I Table Index 

58 Group Index Pointer 

(lounted Private Volune Set 
159 



60 

61 
62 
63 
64 
65 
166 



H-H-H-i-H-M-M-M-H 
0123456789012345 
111111 

* The femat for UCAP (Z46-47) is as follow: 



| 0! 1| 2| 31 4| 51 61 7| 8| 9|10|11 |12|13|14|15| 

|..|..|-|„|-.|~|~|~|"|--I--I--I"I~I"IH 
U0RD1|Sn|Rn|AL|Gl|DI|0P|CViUV|LG| |PS|NA|Nfl|CS|NDl$F| 

|..j-.|..|-|..|..j..|.-|-|-|-|--|-|-|--|-| 
U0RD2I IBAIlAIPni |nR| IDSIPNI 

j l-l-l-l l-l-l-l-l 
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Job Infomat» " Tablt (JIT) (Cont.) 



111111 
0123456789012345 
H-l-H-l-l-H-H-l-H-H-l 
34 | I28 

35 1 JITUN 1 29 

36 1 USER NARE 1 30 

37| 131 

| 1 

| 40 1 POINTER TO JITAIP (Z65) 1 32 

. | - 1 1 

| 41 Pin) POINTER TO JITGIP (Z67) |33 

| . | 1 

42 1 LATTR 1 34 

43 1 LOCAL ATTRIBUTES 1 35 

| 1 

PASSF 1 36 

45 1 PASSED FILE POINTER 1 37 

46 1 UCAP 1 38 

47 USER CAPABILITY * 1 39 

50 I RESERVED FOR DS'II |40 
1 

51 JITCPUCCHGROUP |41 
52 1 CPU ns used since last CHGROUP |42 



S3| 

54 
55 

56 
57 



P - Group's hone volune is 
a private volune 

fl - Private volune nounted 
(i.e., group bound to hone 
volune set), JITGIP - Z71 



LOCAL RIN POINTER 



JITJN 

J08 NAM 



-I 
I43 



— I 



I44 
I45 
I46 
I47 



-l-H-H-l-l-H-l-l-l-l-l-l 
0123456789012345 
111111 
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Job Tables 



Allou naax Fornat 

** The Allou nask for RPE V ie expanded to six uords. There is a nask in 
each user's JIT and the global allou nask in the SYSGLOB extension area. 
The Allou nask contains enough bits for a one-to-one correspondence to 
mry present OPERATOR type connand, or any future OPERATOR eonnand. Uhen 
a user is ALLOUed any OPERATOR eonnand or ASSOCIATE* to a device (uhich 
uill use OPERATOR type connands) then the corresponding bit(s) in the nask 
in that user's JIT for that connand is set. If the ALLOU or ASSOCIATE uae 
done on a global scale, then the bit(e) in the naek of the SYSGLOB area 
is/are updated. 

The following EQUATES define the nask bit for each operator connand. 

The first set of cotmands define the operator connands dealing uith 
devices. 

Uhen adding a neu connand to this set of EQUATES, be sure to add a 
corresponding neve statenent in LOGMAGE, even if the connand uill not be 
logged. 





Uord 


Sil i 


A60RTI0 








ACCEPT 





1 1 


DOUM 





2 2 


GIVE 





3 3 


HEADOFF 





4 4 


HEADON 





5 5 


REFUSE 





6 6 


REPLY 





7 7 


STARTSPOOL 





8 8 


TAKE 





9 9 


UP 





10 10 


ftPUKE 





11 11 


DSCONTROL 





12 12 


UPPER LMIT -> DEVICE COMRNDS 


ABORTJOB 





13 13 


ALLOU 





14 14 


| ALTSPOOLFILE 





15 15 


ALTJ06 


1 


16 


BREAKJCB 


1 


1 17 


| OELETESPOOLFILE 


1 


2 18 


DISALLOU 


1 


3 19 


JOBFENCE 


1 


4 20 


LMIT 


1 


5 21 


STOPSPOOL 


1 


6 22 


SUSPENDSPOOL 


1 


7 23 


OUTFENCE 


1 


8 24 


RECALL 


1 


9 25 

G. 23.00 
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Job Tables 








Uord 


fiit ft 


RESUAEJ08 


1 


10 26 


RESUflESPOOL 


1 


11 27 


STRERflS 


1 


12 28 


CONSOLE 


1 


13 29 


UARN 


1 


14 30 


UELCOflE 


1 


15 31 


HON 


2 


32 


HOFF 


2 


1 33 


VHOUNT 


2 


2 34 


LflOUNT 


2 


3 35 


LDISflOUNT 


2 


4 36 


ARJECONTROL 


2 


5 37 


JOBSECURITY 


2 


6 38 


DOWNLOAD 


2 


7 39 


AMENABLE 


2 


8 40 


niOOISRBLE 


2 


9 41 


LOG 


2 


10 42 


FOREIGN 


2 


11 43 


| MFCONTROL 


2 


12 44 


SHOUCOI1 


2 


13 45 


QPENQ 


2 


14 46 


SHUTQ 


2 


15 47 


I DISCRPS 


3 


48 



Job Tablet 



Job Directory Table (JOT) 
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, 1 

0| flAX SEGflENT SIZE (WORDS) I 
| 1 

1 | POINTER TO JDSO I 
| J 

2 | POINTER TO JTFD I 
| 1 

3 | POINTER TO JFEO I 
| 1 

4 | POINTER TO JLEQ I 
| 1 

5 1 POINTER TO JJCU | 

6 1 POINTER TO FREE SPACE I 
| 1 

UORK RRER 
45 UOROS 
|-., 1 

JOSJNUn|TY| Nun I 

l_.l 1 

I RESERVED FOR SYSTEfl | 
, 1 

I JsnPiN l 
i J 

JOB DflTR SEGflENT 
JDSO" DIRECTORY 

! ! 

JOB TEflPORRRY FILE 
JTFD_ DIRECTORY 

JOB FILE EQUATION * 
JFEQ_ TABLE 

, 1 

JOB LINE EQURTION 
JLEQ- TABLE 

JOB CONTROL UORD 
TABLE 

| FREE SPACE I 



1 entry per job 
OST N in uord 10 
(bate 10) oF PXGLOB 



| 1 1 

| ENTRY | NAflE I 
I SIZE (UDS)| SIZE (UDS)| 
| , 1 

I C1 I JZ I 

, 1 1 

I CN |_ (Z40) | 

| ENTRY | 

| INFORflATION | 
I j 

The nane it a concatenation of 
up to three tubnanes. Bit of 
the 1st character of each 
tubnane it 1. 
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Job Tabltt 



Job Data Sequent Oirectory Entry (In JPT) 

If a OST it allocated at tharablt, then it uill have entriet in both the JOT 
and PXFIX. Sharable neant that it can bt be thared by all procetttt in tht 
Connand Interpreter procett tree (tout, etc.). Nontharable DSTt only have 
entritt in tht PXFIXEO. 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

i — i — i— i— i — i — i— i— i — i — i — i— i— i— i — i— i 

I 4 I 1 I 



Job Tablet 



File Eouation Table Entry (In JPT) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|~|..|~|.-|--|~|--I~I"!--I~I"I--I~I-IH 
| ENTRY SIZE I NAflE SIZE I 
| (UORDS) I (UORDS) I 



SEGflENT 10 



-I- 



I * OF PROCESSES ACCESSING 
| 



EXTRA OATR SEGflENT OST INOEX 



-I 

I 



NOTE: A return of 22004 in the INDEX value after uaing tht GETDSEG 
intrintic indicatet that there it no nort roon in tht Job Directory 
Table for another job tharablt data ttgntnt. 

Job Tenaorarv File Entry (In JPT) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 IS 
M-IHHHH-M-I-M-I-MHH 
I ENTRY SIZE I NAflE SIZE I 

| (UORDS) | (UORDS) I 

, 1 1 



NAflE - ACTUAL FILE DESIGNATOR 



I 
I— ■ 

I 



VOLUflE POINTER I 
1 

FILE LABEL POINTER 



-—Nane nay contitt 
' of up to 4 tubnanta 

(File. Group. Account: 

ENVIP) 



I- 

Since all ton procetttt of a CI thare the aane JPT, cxelutive accett of tht 

JOT it controlled uxth the Job SIR (JIR) and it locked and unlocked by call* 
to LOCKJIR and UNLOCKJIR. The JIR nunber it found in the PXGLOBAL area 
(JPCOUNT index). Only job and ttttiont tracet have JIRt, tytten procetttt do 
not, even though they have JOT$. The JOTt uere provided for tytten procetttt 
for contittency, but are not neant to be inereated or reduced. 
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NAflE - (FORflRL DESIGNATOR) 



PflASK 



NRflE LENGTH 
(BYTES) 



DEVICE LENGTH 
(BYTES) 



1 



NflflE-RCTURL DESIGNATOR 
(nay not be present) 



DEVICE/CLASS NAflE 

(nay not be preeent) 

FOPTIONS 



AOPTIONS 
N6UFFERS 
RECORD SIZE 
• EXTENTS I 



-| M-l- 

| INIT ALLOC ID |T |S 
.| l-l-l- 

| BLOCK FACTOR 



FILE 



I I- 



SIZE 
FILE CODE 



I OUTPRI | 
I I-— 

| REF COUNT 



M OF USER LABELS 



LPNGUAGE (NATIVE LANGUAGE SUPPORT) 



I LENGTH 

I FORflS / LABEL 



FORflS * / LABEL * 
ARRAY 



-DISPOSITION: 
BIT13 OEL 
BIT14 TEflP 
BIT15 SAVE 
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Jeb Tablet 



Job Lint Equa tion (JLEtn Entry 



-I- 



| ENTRY SIZE I OESIG. SIZE 
I (UOftDS) I (UOROS) 
| 1 ] 

FQRflAL LINE DESIGNATOR 
(1-4 UOROS) 



1 
2 

3 

4 

51 

6 

7 

10 
11 
12 

14 

15 
16 
17 
20 
21 
22 

23 
24 



PI1ASK1 



REF CUT 



-I 1- 



| P | PHASK2 
...| 1 

NRI1E LENGTH I DEV LENGTH 



-I- 



NAI1E 



( ENO OF LEQ ENTRY IF HON- BLANK ) 



DEVICE 



PAASK3 



DRIVER NRflE I 
LENGTH | 



DRIVER NRRE 



QST PNTR 



COPTIONS 



ROPTIONS 
DOPTIONS 



P«FLAG 



20 
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Job Ttbltt 



OPTION UORD 2 
(ROPTIONS) 



flopticnt and Fcntiont Uord Brtthdctm 



OPTION UORD 1 
(FOPTIONS) 



3 
4 
5 

6 

7 
8 
9 
10 
11 
12 



15 



COPY 
NO-WIT 



HULTI- 
ACCESS 



I 



INHIBIT BUFF. 
EXCLUSIVE 



IDYNRfllC LOCKING 
HULTI- 
RECORD 



ACCESS TYPE 



FILE TYPE 



DISRLLOU FILES 

LABELED TAPE 
— | CARRIAGE 
CONTROL 



RECORO FORRflT 



DEFAULT 
DESIGNATOR 



ASCII/BINARY 
DOnAIN 
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Job Ttbltt 



Job Lint Equation fJLEQ) fntrv fCont.) 



NUHBER OF BUFFERS 



BUFFER SIZE IN UORDS 



INSPEED (2 UORDS) 



251 

I- 
261 

I- 
271 

311 OUTSPEED (2 UORDS) 
| 

331 POLL REPEAT 
, 

34| POLL DELAY 

| 

351 C TRACE INFO 

| 

361 LOCAL ID PNTR 

37| REHOTE ID PNTR 
401 SUPLIST PNTR 



I- 
41 | PHONE LIST PNTR 

| 

42| POLLIST PNTR 

I 

431 DISC ARRAY PNTR 



I- 



-I 

121 
-I 

122 
-I 

123 
-I 

125 
-I 

127 
-I 

128 
-I 

129 
-I 

130 
-I 

131 
~! 

1 32 
-I 

1 33 
-I 

I34 
-I 

1 35 
-I 



, *^^Pll!|k 



REL TO ORIG 
OF LEQ ENTRY 



Job Control Uord Table (JJCU) 



, , 1 

| NAHE SIZE I I 

I (BYTES) | I 

i 1 i 

NAHE 

I I 

I «... I -••••——•-«•»•••«»»••—•«-• i 

I TY | HODIFIER I 

HODIFIER » VALUE FROH TO X377777 



Nant n*y bt any alpha- 
numeric string, begin* 
ning uith an alpha, 
betuttn 1 and 255 char- 
acter* long. 

TY 00 * OK 

01 « UARN 

10 * FATAL 

11 * SYSTEfl 
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Job Tablet 



PHASK Uord Brtakdoun 





| 


FILE TYPE 




LABELED TAPE 




FRI1S nESSRGE 




USER LABELS 




LANGUAGE 




VTERfl 




POINTER ENTRY 




DYN. LOCKING 




UAIT.NOUAIT 




HULTI ACCESS 




NUrtCOP 




OUTPRI 




FILECOOE 




FILESIZE 




NUHEXTS 




INIT ALLOC 






|... 



/ pnASK UORD 2 

| / PnASK UORD 1 

I I 



BLOCK FACTOR 

RECSIZE 
DISPOSITION 
NUHBUFFERS 
INHIBIT BUFFERING 
EXCLUSIVE 
nULTI-RECORD 
RCCESS TYPE 
COPY.NOCOPY 
ICRRRIRGE CONTROL 



-I — I 



■ I 



(RECORD FQRflAT 



—I— I 



I DEFAULT DESIGNATOR 



|ASCII/ei««ARY 



1 ■ info 
" info 



lOOCAIN 
— I 

I DEVICE 
I— I 

iNRftE 
-I 

15 



prttent 
absent 



\ 
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Job Tables 



UCQP Rtauest Queue (OST it 9) 



The UCOP Request Queue (URQ) ie used to to signal UCOP that a process is 
requesting process deletion. The URQ is a circular queue using a FIFO 
algonthn to process requests. Uhen the next available pointer is equal to 
the next request pointer, then the table is enpty. Uhen tht next available 
oointer is (logically) one less than tht next request pointer and the request 
is entered, then the table is full. A full table uill cause Systen Failure 1 
(SF1). Thus, the last (logical) entry cannot be used, An entry is added via 
a call to REQUCOP. 

The UCOP Request Queue (flPE IV) uas previously used for nany functions such 
as stack expansion, but those functions noved to other areas uith flPE V. The 
only valid entry nou is a type 2 entry (process deletion). The original 
fomat is retained in the event that nore functions are added. 



Job Tables 



I- 
01 



nflXN REQ ENTRIES N/2 



TABLE RELATIVE POINTER TO NEXT AVAIL ENTRY |- 



21 TABLE RELATIVE POINTER TO NEXT REQUEST |- 



I — 
31 
— I — 
* I 
I I 
I I 
I I 
I I 
I I 
I t 
I 
I 
I 
I 
I 
I 
I 

N I 
UROSI 
I I 



REQ 1 



REQ 2 



I 
I 
I 
I 

I I 

I I 

I I 

I I 

I I 

I I 

v I 

— I- 



-\ I 
I I 
I i 
I I 
I I 
I 
I 
I 
I 
I 
I 
I 

-/ 



< / 
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Relocatable Object Code 



CHAPTER 9 RELOCATABLE OBJECT CODE 
USL Filts Introduction 



> USL record length is aluays 128 uords 

> Layout of double-uord disc addresses: 



| 25-BIT RECORO N 




24 25 



UORD « I 
UITHIN RECORO I 



- Hash links join all entries uith the sane hash key regardless of 

type 

- Linear lists terninate uith a zero link 

- Circular lists containing only the list head point directly to 
thenselves 

- Single-word disc addresses: 



9-BIT RECORD N 



-I— 

I 

I 

-I — 

8 9 



1 

UORO « I 

UITHIN RECORD I 

1 

15 



Uninitialized fields are reserved for future use and should 
be set to zero. 

Record and Overall USL File Fomat 




LOADER ID 
NR. DIRECTORY ENTRIES 
DIR. lENGTH 
TOTAL DIR. GSREPGC 
NR. DIR. CrARB. ENTRIES 
S.A. BLOCK DPTA LIST 
S.A. INTERRUPT PROC. LIST 
S.A. StOPENT LIST 
FILE LENGTH 
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NOTE: 

S.A. « Starting Addreee 



UCOP Entry Forwat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

1 

PIN 



Each entry is 
2 uords long 



2 PROCESS DELETION 



G. 23.00 
8- 23 
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I 








121 


SAAO 


10 


S.R. AVRIL DIR. 


13 


RDL 


11 


AVAIL DIR. LENGTH 


14 


SAI 


12 


S.A. INFO BLOCK 


15 




13 
14 




16 


IL 


INFO BLOCK LENGTH 


17 




15 




20 


SARI 


16 


S.A. AVAIL. INFO 


21 




17 




22 


AIL 


18 


RVRIL INFO LENGTH 


23 




19 




24 


TOTAL 


20 


TOTAL INFO GARBAGE 


25 


1.6. 


21 
22 




26 


NIG 


NR. INFO GARB. ENTRIES 


27 




23 




30 




24 




31 




25 




32 




26 




33 




27 




34 




28 




35 




29 




36 




30 




37 




31 




40 




32 




41 


HL 


33 


HASH LINKS 


177 


I HL 94 


127 
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Relocatable Object Codt 



USL filtt General Information 



0| 10 

I I 
I RECORO | 
I I 
I I 
177| 1127 

/ 200| 1128 

I I I 

| | OIRECTORY | 

I I I 

01 < I ENTRIES I 

I I I 

I I I 

\ I 1 

I 

/ I 1 

| SRRO | | 

| I AVAILABLE I 

RDl < I DIRECTORY | 

I I I 

\ I 1 



I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
32K 

hrx 

i 
I 
I 

I 
I 
I 
I 
I 
I 
I 



/ 
I 
I 

IL 

I 
I 
I 
\ 

/ 

I 

fill 

I 
I 
\ 



SAI* I 1 

i I 

I INFO I 
I (HERDERS) I 
I (CODE) I 



I 



SRRI I- 

I I 

I AVAILABLE I 
I INFO I 
I I 

FL-1 I 1 



* SAI nutt bt on a rtcord boundary 
NOTE: All addrtattt in ncord art word 
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Rtlocattblt Objtct Codt 



TYPE 



Data Oetcriotors. Paittd Parawtttrt 



1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 
I — I — I — I — t — I — I — l — I — I — • — I — I — I — i — I — I 

| HODE I STRUCTURE I TYPE I 
, 1 1 1 



UQRD3 



COOE 



NULL 







LOGICAL 


1 


1 


INTEGER 


1 


2 


BYTE 


1/2 


3 


REAL 


2 


4 


DOUBLE 


2 


5 


LONG 


3 


6 


COMPLEX 


4 


7 


LABEL (SPL) 




10 


CHARACTER (STRING) 


N/2 


11 


LRBEL (FORTRAN) 




12 


UNIVERSAL (HATCHES ANY TYPE) 




13 


STRUCTURE 






SIHPLE VRRIRBLE 







POINTER 




1 


RRRRY 




2 


PROCEDURE 




3 


RODE 






NULL 







VALUE 




1 


REFERENCE 




2 


NRHE 




3 



NOTE: A dttcriptor of rttultt in an autonatic natch. 
PatceJ . 

Pascal tttt tht high ordtr bit in tht parantttr type dttcriptor uhtn 
it it gtntrating hathtd values. Tht renaining 15 bit* are bated 
on a hath of tht types of tht parantttr. Only tht Patcal conpiler can 
conpute tht valut, and tht SEWENTER nutt natch tht uhole 16 bit valut. 
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Rtlocattblt Objtct Codt 



USL Filet Ce ntral Information (Cont.) 



SflSL — >| 1 

I SEGL I 

I I 
I SEG.A | 

! U 

I 1 I 



I 



•I- 
~>l 

I 

I 

I 
/-I 
I I- 
I 
I 
•-/ 



1 

SEGL I 

I 
SEG.K I 

I 
SUBL |-\ 



I SEG.B I 



-I 



I 

I 



I 

M 
I | 

I 
I 
-\ <- 



^ 



\ 



I 1 

->| SUBL I- 
I I 
| PROC.C I 



>| SUBL I 



I 



I 



I 
|-\ 

-I I 

I 
I 

I 



| PROC.A | 



I 

M 
I I- 
I 
I 
I 
-/ 



SECL 



I 

|-\ 
-I I 



I- 
->| 

I 
I 
I 

M 

I I- 

I 

I 

I 
-\~ 



SUBL 

nfliN 



CIRCULAR LINK POINTS TO ITSELF 
IF LIST IS EHPTY 



I 1 

->| SECL I 

I I 

| PROC.A I 
I 3 I 
I I 

| 1 



A\ 

K > Stgntnt nana tntritt 

B/ 



I- 



-I 



— >| SECL I- 



I 

I PROC.A 

I 1 



| 1 

->| SECL |~ 
I I 

I PROC.A | 
i 5 | 

I I 



PROC C \ 

PROC A >Subpregran 

nfilN / entries 



A \ 

3 I 

A I 

1 > Secondary entry point entriet 

A I 

5 / 
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Relocatable Object Code 



Entry Type 



GARBAGE 

| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

| |..|-.|..|-|..|.-|-|~|-l-l-j-l-l-l-l-l Nunber of Hords in this 

Ml Nil | I block 

, ,.., 1 j 

I I 

I I I 

| | GARBAGE I 

N I 

, , 1 



Entry Type 1 



SEGHENT NRHE 



111111 
23456789012345 
l-H-H-H-l-H-H-H- 
NU | 1 

1 



1 
H- 

0| I 

H- 
II 

l-l 
2IAI 

l-l 

31 
I 

1 . 
I . 

| CHAR. NC 

I- 

I 

l-l 

I L| 

l-l 



(VARIABLE • CHAR. SEE NC) 



SEGL 



SUBL 



Ml - Nunber of words in entry 
block 

HL - Hash link - points to ntut 
entry having the sent 
hash codt 

A - Activity bit 

if active 

1 if inactive 
(initialize to 0) 

Note: An inactive ttgntnt 

inplits that all entry 
pointt art inactive 

NC - Nunber of characters in 

nam. flax it 16 
CHAR. 1 - First ehtracttr in 

variable field 
CHAR. NC - last character in 

variable field 
SEGL - Segnent link - pointe to 
next segnent nana entry 
SUBL - Subprogran link - points 
to next entry having 
the oene ttgntnt nana 
L - Laat entry in litt 

if not latt 

1 if latt 



G.23.00 
9- 6 



~)) 



Relocatable Objtct Code 



Clarification Notes on E ntry Types 2 and 4 
Uith Reioect to SPL and FORTRRN 



•ENTRY TYPE 2 "ENTRY TYPE 4 *ENTRY TYPE 2 "ENTRY TYPE 4 
SPL 0.8. SPL PROC FORTRAN flflIN FORTRRN SUB. 



1.5 

TSOB 

NUPUST 

5 

NUSD6 

Where: TPDB > 
TSDB • 
NUPUST ■ 
NUSOB < 
NUO 
NUD 



TSOB 
NUPUST 



1,2,3,4 1,2,3,4 
TSDB TSOB 



NUO 



NUPUST 



NUO 



NUPUST 



Total prinary OB length in uords 
Total secondary OB length in uords 
Nunber of uords in "TRACE" array 
Nunber of uords in secondary OB array 
Nunber of uords in oun array 
Nunber of uords in data array 



Notes: 1. Does not include the length of the ST IT 

2. Does not include the length of the FLUT 

3. Does not include the length of any connon array 

4. Includes the length of any DB-allocated fomat array 

5. Are not necessarily equal 

In general TPDB and TSOB are sunnations of storage allocated in the global 
area of the progran's data segnent. They are not, houever, conplete since 
the conpilers are not auare of all storage actually allocated! The STLT 
and FLUT are exanples of this since these tables »rt constructed by the 
segnenter. Connon arrays also present a problen since their inclusion in 
TPDB and TSOB night cause their storage requirenents to be counted nort 
than once. 
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Relocatable Object Code 



Entry Type 2, 



OUTER BLOCK 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
,..|.-,.-,--|-.|"l~l--l"l"l--l~l--l--IH" 
|| NU I 2 
,.., 1 

I HL 



I Al C| 
l-l-l 



II I 
■I~l- 



NC 



-I- 



CHAR 1 



(VARIABLE N CHAR. SEE NC) 



I 
IH- 



CHAR NC 



-I- 



! LI 

LI 

-I 



SUBL 
SECL 



SSA 



SAC 



-l-l- 
F| Ul 
-l-l- 



RELATIVE TO SAI 
(SEE RECORO 0) 



SE 

TPOB 

TSDB 



NUPUST 






I T| 
l-l- 



NUD/NUSDB 

NH 

SRH 



RELATIVE TO SAI 
(SEE RECORO 0) 



I 
I- 



HOU 
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Relocatable Object Code 



Entry Type 2 (pontQ 



I 



HDU 



l-l— 



I- 



SAH 
HDU 



HDU 



CHAR, 
CHAR. 



NU - Nunber of uords in entry block 

HL - Hash link - points to next entry uith 
sane hash code 

A - Activity bit - if active, 1 if inactive 
outer block 

C - Callability bit set if entry point is 
uncallable 

I - Privilege node bit - set if progran unit is 
to be executed in Privilege node 

NC - Nunber of characters in nane - nw is 16 

1 - First character in variable field 

HC - Last character in variable field 

L - Last entry in list 

if *ot !ast 

1 if last 
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Relocatable Object Code 



£"tnr Typt ? (CQ"t. ) 



SUBL - Subprogran link - points to next entry 
having the sane segnent nane 

SECL - Secondary entry point list link 

SSA - Progran unit starting PB address 

SRC - Starting (FILE) address of code 

nodule 

F - Set if fatal error 

U - Set if nonfatal error 

KUC - Nunber of uords in cede nodule 

SE - Stack size estinott 

TPDB - Total nunber of uords of prinary 
DB to be allocated 

TSOB - Total nunber of uords of secondary 
DB to be allocated 

NUPUST - Nunber of uords in trace array 
(PUST) 

NUD - Nunber of uords in data 9rrw 
(FORTRRN) 

NUSOB - Nunber of uords in secondary 
OB *rr*y (SPL) 

T - Terminating bit - set if last set of 

headers in entry 

NH - Nunber of header* 

SRH - Starting address of header (relative 
to SRI) 

HDU - Header (pointer) 
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Relocatable Objtet Codt 



OUTER BLOCK - SECONORRY ENTRY POINT 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l- 1 

I N« j 3 



HL 

Rl CI I I 
-l-l-l-l- 



HC 



•I- 



CKRR 1 



(VRRIRBLE it CHAR. SEE NC) 
-I 



CKRR NC 



SECL 



-I 



SSR 



Entry Type 4 



PROCEDURE 



1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 
..|..|..|.-|..|-|-l-l-l--l-l-l--!-l-l- 

| NU I 4 



-I- 



HL 



-I- 



-l-l-l-l- 
R I C| II H| 
l-l-l-l- 



-I- 



CHRR 1 



(VRRIRBLE « CHRR. SEE NC) 



CHRR.NC 



-I- 



SUBL 



L I 
-I 
L I SECL 

SSR 
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Relocatable Objtet Codt 



Entry Type 4 (Cont.) 



NU - Nunber of uordt in entry block 

HL - Hath link - pointi to next tntry with sans hash codt 

R - Rctivity bit. if active, 1 if inactive tntry point 

C - Callability bit ttt if tntry point is uncallablt 

I - Privilege node bit. Set if procedure it to bt executed in 
privilege node 

H - Hidden entry point. Set if tntry point Hill not bt in 
library dirtctory 

NC - Nunber of characters in nans, flax it 16 

CHRR1 - First character in variable field 

CHRR NC - Utt eharacttr in variablt field 

L • Last tntry in litt 

if not last 

1 if last 

SUBL - Subprogram link. Points to next entry having the sam segment 

rune 

SECL - Secondary entry point list link 
SSR - Unit starting PB address 
SRC - Starting (file) addrtss of code nodule 
F - Set if fatal error 
U - Set if nonfatal error 
NUC - Nunbtr of words in code nodule 
SE - Stack eize estinate 
TPDB - Total nunber of uords of prinary DB to bt allocattd 
TSOB - Total nunbtr of uords of secondary 08 to b« allocated 
NUPUST - Nunber of uords in trace array (PUST) 
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Rtlocatablt Objtet Codt 



Fntrv Tvee 4 fCont.) 



| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
! -|~|--I--I--I--I--I--I--I--I--I--I--I--I~M 



SRC 



-I- 1 

F | U| NUC 
-I- 1 



TPDB 



TSOB 



NUD/NUO 



P I 



PRRfl. 1 



(VRRIR8LE » OF PRRAS. SEE CN) 



PflRtl. NP 



SRH 



HDU 



ETC 
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Rtlocatablt Objtet Codt 

Entry Type 4 (Cont.) 

HUD - Nunbtr of uords in data trny (FORTRRN) 
NUO - Nunbtr of uordt in nun trrty (SPL) 

P - Parantttr checker 

00 no checking. (Inplies NP undefined. FN and PRRfls absent) 

01 chick procedure typt- (Inplits NP is undefined and PRRfls 
absent) 

10 check procedure typt and nunbtr of PRRfls (inplits PRRfls 
absent) 

11 check procedure typt, nunbtr of PRRfl '• and typt of tach PRRfl. 

NP - Nunbtr of PRRflt 

CM - Characttr count of PRRflt 

TN - Procedure Typt (tee Data Descriptors earlier in thit 
chapttr). 

T - Ttminating bit. Stt if last stt of htadtrs in tntry. 

NH - Nunbtr of htadtrs 
SRH - Starting address of htadtr 
KDU - Header (pointer) 
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Entry Typf 5 

PROCEDURE - SECONDARY ENTRY POINT 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
.-l~l~l~l-l-M~l-l"l-!~M-:M" 



| NU 

HL 

•-I-I-I-I 1- 

fll C| |H | NC I 
-l-l-l-l 1" 



CHRR 1 



(VARIABLE N CHAR. SEE NC) 



CHRR. NC 



-I- 



L I 
-I- 



SECL 



SSR 



NU - Nunber of uords in entry block 

HL - Hath link - points to next entry uith 
sane hath code 

R - Rctivity bit. if active, 1 if inactive 
entry point 

C - Callability bit tet if entry point it 
uncallable 

H - Hidden entry point tet if entry point 
will not be in library directory 

NC • nunbtr of character* in nane, nan it 16 

CKRR 1 - Firtt character in variable field 

L - Latt entry in litt 

if not latt 

1 if latt 

SECL - Secondary entry point litt link 
SSR • Unit starting PB' tddrett 
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Entry Tvot 6 (Cont.) 



NU - Nunbtr of uordt in entry block 

HL - Hath link. Pointt to ntxt entry 
with tane hath code 

R - Rctivity bit. if active, 1 if 
inactive entry. 

IT - Interrupt procedure type matter 

NC - Nunbtr of character* in naite (naxinun it 16) 

CHRR 1 - Firtt character in variable 
field. 

CHRR NC - Latt character in variable field 

IPL - Interrupt procedure link 

DBS - Nunber of uordt of DB storage 
required 

SSR - Unit starting PB' addrtst 

SRC - Starting (file) addrtst of code 
nodule 

F - Set if fatal error 

M - Set if nonfatal error 

NUC - Nunber of uordt in code nodule 

T - Terminating bit. Set if laet ttt 
of headert in tntry 

NH - Nunber of headert 

SRH - Starting addrett of header 

HDU - Header (pointer) 
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Entry Type 6 



INTERRUPT PROCEDURE 




I--I 
I I 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
.-I-.I--M-I--I--I--M--I--IH--I--I-- 

NU I 6 
1 



l-l- 
IR I 
l-l- 
I 

I 
I 



HL 



-I- 



IT "| | NC I CHRR 1 
(VRRIRBLE N CHRR. SEE NC) 



l-l l"l- 

|R I IT I I 
i-l l-l- 



-I 

| CHRR 1 
-I 



(VRRIRBLE N CHRR. SEE NC) 



CHRR. NC 
IPL 
DBS 



-I- 



l-l 

IF I 

l-l 

IT I 

l~l 

I 

I 

I 

I — 

I 

I — 

I 

I 

I 

I — 

I 

I — 



SSR 



SRC 



NUC 



SRH 
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Entry Type 7 



BLOCK DRTR 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
.-|-|--M~|-|~|-|~MH-I~M~M 
I NU I 7 

HL 



-l-l-l-l 

R IF |U | | NC 
l-l-l-l 



BLOCK DRTR NRUE 



CKRR.1 



CHRR NC 



I 
— I- 



CRL 



CHRR.1 



| COnRCN P.RRflY NRftE 

I 



| CH3R.NC 
l-l 

IT i NH 



l-l- 
I 

I 
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Relocatable Objtct Codt 



Entry Type 7 (Cont.) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
— I — t — l — I — I — I — ■ — I — I — I — I — I — I — I — I — 

» , , 



I NC I 
-I 1- 



CHRR 1 



COflHON ARRAY NRHE 



-I- 



CKRR.NC I 
T | NH I 



NOU 



ETC 



NU - Nunbtr of word* in block 

HI - Hath link. Pointt to ntxt tntry uith 
tint hath codt 

fl - Rctivity bit. if active, 1 if inactive 
block 

F - Stt if fatal trror 

U - Stt if nonfatal trror 

CHRR 1 - Firtt characttr in vanablt fitld 

CHRR NC - Latt characttr in variablt fitld 

BDL - Block data link 

CRL - Cormon *rr»y ltngth 

T - Terminating bit. Stt if latt ttt of 
htadtrt in tntry 

NH - Nunbtr of htadtrt 

SRH - Starting addrttt of htadtrt 

HDU - Htadtr (pointtr) 
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Rtlocatablt Objtct Codt 



Entry Typ^ 8 (gon^, ) 



CHRR 1 - Firtt characttr in variablt litt 

CHRR NC - Latt characttr in variablt 
litt 

L - Latt tntry in litt 

if not latt 

1 if latt 

SECL - Secondary tntry point Hot link 
SSR - Unit ttarting PB' addrttt 

P - PRRH checker 

00 No checking (Inplitt HP undefined, 
TN and PRRHS abttnt) 

01 Check procedure typt (inplitt NP 
is undtfintd and PRRnS abttnt) 

10 Check proctdurt typt and nunbtr 
of PRRHS. (Inplitt PRRHS abttnt) 

11 Check proctdurt typt, nunbtr of 
PRRHS and typt of PRRII 

NP - Nunbtr of PRAM 

CN - Characttr count of PRRHS 

TN - Proctdurt typt 
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Entry Type 8 

PROCEDURE - SECONDARY ENTRY POINT 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

-I — I — ■ — I — I — I — I — I — I — ■ — I — • — 1 =-> — ■ — 

| MU | 8 



I--I- 



-I- 



HL 
-I--I-I-I 1 

|C I IH | NC I 

-I--M-I 1 



l-l- 
IL I 



(VRRIRBLE i CHRR. SEE NC) 
CHRR. NC 



-I- 



l-l- 
I 

I- 
IP 



SECL 



SSR 



NU - Nunbtr of uordt in tntry block 

HL - Hath Link - pointt to ntxt tntry 
uith tant hath codt 

R - Activity bit. if activt, 1 if inactivt 
tntry 

C - Callability bit ttt if tntry point it 
uncallablt 

H - Hiddtn tntry point. Stt if tntry 
point uill not be in library 
directory 

NC - Nunbtr of characttrt in nant, nax 
it 16 
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Entry Header Fornat 



SRH >| 



I 



SAH 



SRC 



I 

I 



| 

I HERDER 

| 

I 

>| HERDER 
I 



->| CODE ! 
| j 

I . I 
I . I 
I . I 

I 1 

I HERDER I 
| 1 



SRH • 



>| 

I- 



| 1 



HERDER I 
1 

I 



I 1 

| HEADER I 
I 1 

Each entry (except secondary entry point entries) nust describe N > stts of 
htadtrt. The headers in each stt «ust be continuous and in the sattt order at 
tht KOU list describing the set. 

The code nodule **y be plactd in any position in a header set. Nott that if 
tht codt nodult is at the beginning' of a set, SRC * SRH. 

If the entry has no head»r set, tK?n NH, SRH sequence is absent. 
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Header Type 



GARBAGE 




Header Type 1 
PCALa 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
H-I-M-M-I~M-M-M-M- 

J, 1 ' 



PBA 



-I- 



-I- 



| NC i CHAR. 1 
_, , 



CKRR NC 



P I 



PARH. HP 



r 



PBA - PB' address of linktd list of PCAL instructions to bt repaired - 
loucr 14 bits used at negative disp. - bit act neans that 
the Mord it not a PCRL instruction, but a pointer to a SST label 
of "EXTERNAL" fornat - a link of terminate* the lift - bit 1 
act rteant that the word is to be initialized uith the PB address of 
the procedure. 
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Header Type 4 

OSOB / CUH / DATA / VALUES 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
-I — I — I — I — I — I — I — I — I — I — I — I — • — I — I- 
| NU I 4 
|.., 1 

I LD 
I — I- 
B | IN 

INITIAL VALUES 



LD - Logical uord displacenent 

in oun array for initial values 

B - Byte bit - set inpliee that LD is 
type BYTE and that the first 
uord of the initial value block 
is a count of the nunber of bytes 
in the initial value block 

IN - Integration nunber - nunber of 
tines the block of initial value 
is to appear in the secondary 8D - 

1 - no duplication. 

2 - duplication, etc 



Ht«Qfr Typt $ 
PUST 



i^*\ 



1 2 3 4 5 6 7 8 9 10 11 1? 13 14 15 




PBA 



> PB' address of linked list of 
pointers to be initialized uith 
DB address of PUST (sane list 
fornat as for fornat strings) 
A PBA of -1 indicates NO FIX-UPS. 
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Header Type I 



PB RDORESSES 



I 

I I 

I I 

I I 

I I 

I I- 

I I 

I I 

I I 

I I- 

I I 

I I- 

PBfl 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

| NU | 2 I 

PBA i 



PB' address of PB address 

to be corrected 



eader Type 3 



OUN / DATA VARIABLES 



I 

I I 

I I 

I I 

I I 

I I 

I I 

I I 

I I 

I I- 

I I I 

I I- 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

— I — I — I — I — I — I — I — I — I — I — ■ — I — I — I — • — I 

I NU | 3 I 



-I- 



~l- 



PBA 



-I- 



PBA 



■ PB' address of oun variable 
pointer to be corrected 
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Relocatable Object Code 

NOTE: All references to the PUST include the four-uord header 
that is appended by the segnenter. These uords are not 
present in the header; they are autonatically 
allocated and initialized by the segnenter. 

Header Type 6 

GLOBAL VARIABLES 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 




CKRR NC 



Header Type 7 

EXTERNAL VARIABLES 

0123456789012345 

H-H-H-H-M-M-M-H 

I I 

!-l 

I 

l-l 

mi 
l-l 



I 



I NC 

-I — 



CHRR.1 



I — 



I I 




PBA 



PBA - PB* address of linked lists 
of instructions to be repair- 
ed; louer 8 bits of inst. used 
as nog.' displacenent to next 
instruction; a link of 
terninates the list. 

n - Ronitored variable bit; eet 
if variable is being non- 
itored by OEBUG. 

OA - Logical uord disp. in PUST; 
louer 8 bite of uord uill be 
init. uith prin.OB address 
of variable; OA is present 
if n » 1. 

NOTE: PBA of -1 inplies null list 
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Htader Type 8 



PRIHRRY 08 



1 2 34 S 6 7 890 1 2 34 5 

H-H-H-H-M-M-l-M-H 
II NU | 8 I 
H . hH -.,..-|~ l-l-l— I— I 



|U IU IU |U 
I I 1 I 2 I 3 
| — | — I— I- 

I 
I 

I 



IU IU IU |U 
I 4 | 5 I 6 I 7 
.|— I — I — I — 



| — |— I— I — I — I- 

IU IU IU IU IU I 

|N-5|N-4|N-3|N-2|N-1| 

I — I — I — I— I — I- 

I 

I 



INITIRL VALUES 



I 



U - RODRESS BITS 

00 if no addrttt 

01 if no addrttt 

10 if uord addrttt in ttcondary I 

11 if bytt addrttt in ttcondary I 

N - NUP08 

NOTE: Initial addrttttt that art 
ttcondary 08 addrttttt art 

Rtiatxvt (i.t., thty art 
logical diapltcentntt in 
ttcondary 08). 



Rtlocattblt Objtct Codt 



Header Tvot 9 



CORRON VRRIR8I1S 

0123456789012 
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Htadtr Tvot 9 fCont.l 



NUC - Nunbtr of uordt in eowwn array 

HC - Huitbtr of eharacttrt in coimon 
runt - if blank CQMON 4 CQIT 

OR - logical uord ditp. in PUST • loutr 
8 bitt of uord uill bt init. uith 
prin. 08 addrttt of variable - NOTE 
OR it pre tent if M ■ 1 

8 - Bytt bit 

if tht prinary OB pointtr to bt 
allocated and initialized and LD 
art of type uord 

1 if typt BVTE 

R - Ronitortd variablt bit - ttt if 
variablt it bting nenitortd by 
DEBUG 

NL - Kunbtr of addrttt littt for 
variablt 

LD - Logical ditplactntnt of variablt 
in ccnnon %rr*y 

PBfl - PB' addrttt of linked littt of 
inttruetiont to bt repaired - 
loutr 8 bitt uttd at negative 
ditplactntnt to ntut intt ruction - 
a link of ttrninatet tht 
litt 
PBR • -1 indieattt NO FIX-UP1 



■H-l-M-l-H-H-H- 



34 5 

l-l-l-l 
9 I 



I HC I 
-| 1- 



CKRR.1 



■l-l- 

B|n| 

l-l- 



-I- 
CHRR.HC I 



-I — 
NL 



-I - 



PBR 



I 



l-l-l — 

IBini 

-I-I-— 

LD 
OR 



I 
I 

HL 
I 

I 
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Header Type 10 

LOGICAL UNITS 

| 0123456789012345 
I H-H-H-l-H-M-H-M-H 
III 8 I 10 

I H 1 

I I 
I I 

! i 



BIT HRP 



BIT IMP - Bit nap of logical unite 
rtfertnctd; bit 
corrttpondt to LU 0, etc. 
(1 lett than or equal to LU 
lets than or equal to 99) 



Httder Jyp t 11 



FORIWT STRING 



0123456789012345 
l-l-l-l-l-l-l-l-l-l-H-l-H-H 
II NU I 11 I 
,., 1 j 

I PBR I 
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PBR - PB' addrttt of linked litt of 
pointert to be initialized 
loutr 14 bitt of uord uttd 
at negative dieplaee*ent to 
nent pointer - bit ttt 
neans that the pointer it to 
be type BYTE - a link of 
te ruinates tht Int. 
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Header Type 12 

0123456789012345 

H-H-H-H-M-H-l-H-H 

0|X| NU | 12 I 

,., 1 j 

| ID NUHBER I 



Sub-Header Far Header Type 12 



0123456789012345 
. , 1 1 

X| NU I SU8H0R ! 
., 1 



OFFSET 
FATHER - LINK 



CLASS 
RODE 



-I- 
I TYPE 



-I- 



-I- 
| ADDRESS 



-I- 



-I- 



BROTHER - LINK 
1 1 

NC I I CHAR 1 



IF SUBRTN. PARH OR LBL, ELSE 



III I * 1 IF INDIRECT 



TYPE * IF NO SUBTYPE 
OFFSET OF PRECEDING SUB., OR 



CHAR NC 



VALUE 



ii::::::;::! 

ISPLI 
1 — I 

I VALUE OF EQUATE, 

| ENDING CODE OFFSET OR PARENT 

SUBROUTINE IF SUBRTN PARRHETER, 
PB-REL OFFSET IF LABEL, 
OTHERWISE 0. 



Relocatable Object Code 



Header Type 13 & 14 



0123456789012345 
-l-H-M-H-H-H-H-l-H 

X| NU 113 OR 14 | 
.| 1 j 

ID NUflBER I 

-I 

I 
-I 

I 



FATHER - LINK ( « 0) 
BROTHER - LINK ( * 0) 
SON - LINK ( • 0) 
0) 



1 



I OFFSET OF 1ST SUBROUTINE, OR 



NEXT - LINK ( 

NC I CHAR 1 
1 



1 

I 



LEVEL I 



SPL I LEVEL » IF TYPE 13, 1 IF 14 



For Header Type 12, 13, & 14: 
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FATHER- LINK 



BROTHER-LINK 

SON- LINK 

CLASS/TYPE 

I 

RODE/ADDRESS 

NC 

CHAR1..CHRRNC 

SPL 

VALUE 
LEVEL 



- The offset of the parent procedure of this sub- 
routine. Since no re than one subroutine in a 
procedure can have the sane paraneter and label 
nanes, the FATHER-LINK serves the sane purpose on 
a local level that the ID Nunber does globally. 
Uhen conbined. the FATHER-LINK. ID NUHBER. OFFSET 
coronation provides definitive identifier 
recognition. 

- The offset of the subroutine preceding this one, 
(if any). 

- The offset of the first subroutine (if any) in tht 
procedure or outer block. 

- The identifier class and subclass (See SPL IHS). 

- Set to 1 if a reference paraneter. 

• The identifier addressing node & offset (See MS). 

- The nunber of characters in the identifier nant. 

- The identifier nane. 

- A value (currently 99) identifying the source 
language to Synbolic Debug. 

- See Diagran. 

- See Diagran. 



NU 

SUBKDR 
ID NUHBER 



G. 23.00 
9- 33 



OFFSET 



- The total length in uordt of the header. 

- if non-variablt, 1 if v»r m , 2 if PB *my. 

- A unique reference for each block. (A block it 
a procedure, subroutine, or the outer block.) 
This nunber is kept in the 24th uord of record 
zero of the US I file. It is incremented vttry 
tine a block is processed, and survives fron 
conpile to conpile as long as the USL file is 
not initialized. 

- Stt to 1 if this is a notifiable identifier 
(i.e., a variable). 

- A nunbtr atsigntd to each identifier uithin a 
block. Uhen conbined uith the ID Nunbtr, thit 
uniquely ldtntifits tach idtntifitr in a program 
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RL filt Fomat 



0| 
1 
2 
3 
4 
5 
6 
7 

10 
11 
12 



1 



LID |0 LOADER ID 

FL |1 FILE LENGTH (IN RECORDS) 



2 NR. SECTIONS 
3 



4 

5 
6 
7 
8 
9 
10 



S.A. EXTERNAL SET LIST 



| 1 



| RECORO 
I 



I I 



| , 



I FREE «l 

I 

I 

I 1 



| 



NSI 



NOTE: Uninitialized fields art 
reserved for future ust and 
thould bt ztro. 

NS ♦ 1 



I FREE flAP | 
I NS-1 



| 1 



AVAILABLE 



HL 




177| 



HL 
I 94 
I 



133 S.A. HASH UST 



1127 S.A. HASH LIST 94 
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Storage Hanasenent 



Filt space it nanaged in tirnt of 32 uord blocks (4 blocks per 128 uord 
record). 

frtt space (blocks) it accounted for in a bit nap, which it partitioned into 
records (2K blocks ptr section), R indicates that a block is used, a 1 
indicates that it is frt: 

File spacs is also partitioned into 512 record sections (64 n»*. sections, 
2K blocks per section, 1 nap per section). The mmber of sections in a file 
is NS * (FL ♦ 511) & LSR(9). The first NS records following record (records 
1 to NS) are reserved for the section naps. 

fl conplate file address uould have the following configuration: 



1111111111222222222233 
01234567890123456789012345678901 
| 1 1 1 1 

| | SECTION | BLOCK | DISPLCIIT I 



File (uord) Address 
Oouble Uord 
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I 1 

I HI | 

| 1 



->| LINK 
| 

I USEO 
| 

I 
I 
I 



Entry Point Oirectory 



->| LINK 

I 

I USED 
I 

I 

s 
I 
I 

I 

I 

I 
I 
I — .... 




The directory is partitioned into 95 HRSH LISTS (sane HRSH function as USD; 
each HRSH LIST is a linked list of records. 

Each record contains a successor link (record II ) and a used space count. R 
link of terninatcs a list. Uhen a record is void of entries (USED«2), its 
space it returned to the free ttorage area. 
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Relocatable Object Code 



TyPfcaj Directory g^ry 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



Procedure Information Block 
15 



S IU II | | 
-|--|~|~l" 



-• — I — t — 1 — I — I — I — I — I — I — I — • — I — I — ■— 



CHflR 1 



-I 



CHflR. HI 



S.R. INFO BLOCK 



S.fl. ENTRY 

IF |U | NU COOE 
-|~| 1 

IX 1 KP | CN 

TN 



S - Secondary entry point bit - tet if the entry 
point uat originally a tecondary entry point 

U - Uncallable bit - set if entry point is uncailable 

I - Privileged node bit - set if code 
nodule is to be run in "IVILEft BODE 

LC is (0:2)... Level of Checking 

* No checking 

1 • Check fcr procedure type 

2 « Check for « paraneters 

3 « Check for parjnktcr type 

MP is (2:6) is « parineters 

CN- Character count 

TN- Procedure Type (see Da*» Descriptors earlier in this chapter). 
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NU INFO 



NUCCDE 

« ENTRY POINTS 



CODE RODULE 



EXTN LINK 

TPDB 
TS08 
NUSOB 
HERDER 

HEADER 



HERDER 
-1 



\ 

I 

I 

> NUC 

I 

I 

/ 



> KUI 



1 "') 



Rll headers for the procedure are appended to the info block. The 
header tttt (EXTERNAL LISTS) »rt linked by increating file 
addrctt; a link of Zl 77777777770 teminatee the list. 
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Headers 



0123456789 
I l-l-l-l-l-l-l-l-l-l 
III NU 
, ,..,.., 

|F |U | NU CODE 
,..,.., 

| S.A. INFO BLOCK 

I 

, 

I S.fl. ENTRY 

I PBfl 

l-l-l-l-l 

IS IU II I I KC 
l-l-l-l-l 



I 



10 11 
l-l 

I 

I 



12 13 
l-l-l 

1 



14 15 
l-l 






| 



CKRR 1 



| CHAR.NC 

I 1 

I IX | NP 
| 1 

I TN 

| 

I prrh.1 



I- 



F - Set if fetal error 

U - Set if non-fatal error 

S - Satisfied bit - set if EXTERNAL it 

satisfied within RL 
U - Uncallable bit 
I - Privileged bit 

nodule is to be run in PRIVILEGE flODE 
LC is (0:2)... Level of Checking 

* No checking 

1 « Check for procedure type 

2 « Check for tt paraneters 

3 * Check for paraneter type 
NP is (2:6) is • paraneters 

CN- Character count 

TN- Procedure Type (see Oata Descriptors earlier in this chapter). 

Rll headers »rt the sane as in a USL except for the PCAL header. 
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| 1 

0| FLAGS |0 
I 1 

1| NS M 
| 1 

2| CS |2 
I 1 

31 SRC 13 
| j 

4 1 SRS |4 
| 1 

51 ISS 15 
| 1 

61 IDLS 16 
I 1 

7| nnxo |7 

I 1 

101 SRE 18 
| 1 

11 



12 



17| 



22 
23 



SSEG 



19 
1 

SfiDR |10 

SRSTLT | 11 
1 

SRFLUT 112 
-I 



CHCPTER 10 PREPARED OBJECT CODE 



Progran File Fornat 



NimBER OF CODE SEW1ENTS 

GLOBAL SIZE (OB TO QI) IN UORDS 

GLOBAL RRER RECORD it 

SEGTIENT SET RECORD « (EACH SEG. STARTS IN NEU RECORD) 

INITIAL STACK SIZE IN UORDS 

INITIAL DL SIZE IN UORDS 

MM. DATA SEGHENT SIZE (DL TO Z) IN UORDS 

ENTRY POINT LIST RECORD i 

STARTING SEGHENT • 

PRIN. ENTRY PT PB RODRESS 

DB ROR. OF STLT (-1 IF NO STLT) 

(STLT*Segnent Length Table) 
DB ADR. OF FLUT (-1 IF NO FLUT) 



SAX 



113 
-I 



EXTERNAL LIST RECORD I 
SSTT | 14 PRIN. ENTRY PT SST N 

STARTING ADDRESS OF TRAPCOIT 
STARTING RECORD OF PHAP INFO 
STARTING RECORD OF SYHBOLIC ITERS 



-I 
SRTC 115 

SAPrlAP |16 



SASI 



117 
-I 



FLAGS2 |19 
1 

CKSUn |19 
1 

I20 



1 



TOTAL CHECKSUn OF ALL SEGMENTS 

\ 
I 

I 



121 > Three uords reserved for HPE/XL. 



—I 

1 22 
—I 
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Prooran File Fomat (Cont.) 



27 
30 

31 
32 
33 

34 



23 NOTE: ALL UNUSED UORDS ARE RESERVED FOR 

FUTURE USE AND SHOULD BE SET TO 
1 24 ZERO. 



25 



CST | CST 
I 1 



CST | 
n I 

-l-l-l 

IPISI SL 
III 

l-l 



PISI SL 
I I J« 



27 



28 \ 

I 
I 
> 
I 
I 

/ 
\ 
I 
I 
I 



CST RERAPPING ARRAY 



SEGflENT DESCRIPTOR ARRAY 



P - PRIVILEGED HODE 

S - Segnent STT fornat: 0« old fomat; 1» neu (extended) fornat 

N * NS -1 

K = 2S ♦ (*S *1)/2 

L * ((28 ♦ NS ♦ (NS ♦ 1)/2 ♦ 127J/128) 128 
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Flags 



| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l 

| IF |U |Z IP | I I IBAIIAIPrll | IURI IDSIPHI 

I l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l 

F - Fatal error in progran 
U - Non-fatal error in progran 
Z - Zero unit DL area 

P - Set if »ny SEG ie privileged node (if not set nornal > 
nonpriv node) 



CAPABILITIES 
/ [BA] (7) BATCH ACCESS 



ACCESS TO 

GENERAL 

RESOURCES 



I 

I [IR] (8) INTERACTIVE ACCESS 
I 

I [PR] (9) PRIVILEGED RODE 
I 
I 
< 
I 
I 

I [MR] (12) HULTIPLE RINS 
I 

I [OS] (14) EXTRA DATA SEGHENT 
I 
\ [PH] (15) PROCESS HANDLING 
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Flag»2 



I o 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
, — | — | — | — ! — | — i — | — | — | — | — I — I — I — I — I — I 
| |T |K | RESERVED 
, ,..,.., 1 

T - Patch *n* existed in ill codt stgntnte 
K - Checksun valid 



W Renappipg Rrray 



Contains tht last CST mmbere assigned to tht oegnents, indexed by segnent 
nunbcr. Uhen a progran flit is prepared, tht array is initialized to 0. 
1....N. This array is used to rt-istablith intra-progran linkage uhen the 
progran is loaded. 



Segnent Descriptor Array 



Contains the segnent length and a flag indicating if the segnent is to be 
loaded in privileged node, indexed by segnent nunber. fill segnents begin < 
a record boundary. The nunber of records for a given segnent is (SI ♦ 
127J/128. The record nunber, SRS, of segnent H (0 <«N <«MS-1) it: 

If N > then 
FOR 1*0 TO N-1 

BEGIN 

SAS:*SAS ♦ (SL(I) ♦ 127)/128 

ENO 
ELSE 

SAS:*SAS; 

Global Rrea Fornat 

R set of recordt containing tht initial ttt btgint at record SRG (Uord 3) < 

consists of (GS ♦ 127J/128 recordt. 



G. 23.00 
10-4 



Prepared Object Code 



I NC | CKRR 1 



Entry Point Liot 



1~ 

CHRR NC I 



-I- 



P.B. RDR 



STTi 



| NC 1 CHRR 1 


CHRR NC | 
P.B. RDR 


STT i 





I — 






LIST TERniNRTM 



NOTE: The entry point list nutt imtdiattly follow tht external 
list. 
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Eicternal list 



7 8 1 
-l — l 

|NC | CKRR 1 
-I — I 



CHRR NCI 
1- 

NR 



STT N | SEG « 
1 



-I- 



STT II I SEG t 

-I 1 

LCI NP | CN 

"I 1 

TN 



TYPICAL ENTRY 



CHECK 

I 
I 



\ 

I 

I 

I 

> NR 

I 

I 

I 



I CHECK 

I 
I 



1 &2 



PRRn 1 



~"~l 

PRRH NP | 



s**mK 



CHECK 3 



| 1 

| I LIST TERMNRTQR 
I 1 



IX (0:2) - Level of Checking 

>« No checking 

1 >« Cheek for procedure type 

2 >« Check for II paranetcrs 

3 >* Check for paraneter type 
NR • Nunber of Rtferencet 

NP (2:6) « Nunber of Paranetere 

Parn1...Parn NP * Contain Data Detcriptors docunented 

in Chapter 9, "Relocatable Object Code" 
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Prepared Object Code 



Code Seenent Uith Patch Rrea 



CODE 



PATCH 
RRER 



STT 



NRffE 



SEGffENT 
NRffE 



CKEOCSUn 



PREP TME 
PRTCH TIffC 



PATCH 
RRER 



PRLEN 
STT 



Patch Area 

4-UORD PROGRRH NAUE 

8-UORD SEGnENT NRffE 

1-UORD UNUSED 
1-UORD CHECKSUd 
2-UORD PREP TlffC 
2-UORD PRTCH TIRE 

1-UORD PATCH AREA LENGTH 



'Wsk 
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Prepared Objtct Code 
PHRP Information 



SPP 



APD 



PHRP Tvoe Table 



PTTL 



LPRO 
LPR1 



LPRn 
NOTE: n ■ PTTL - 2 



PHRP TYPE TABLE 



SEGflENT PHRP POINTERS 



RCTUAL PHRP DRTUn 



TYPE TABLE LENGTH 

LENGTH OF PHRP RECORD TYPE 

LENGTH OF PHRP RECORD TYPE 1 

LENGTH OF PHRP RECORD TYPE n 
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Prepared Objtct Codt 

Tvot 2 Secondary Entry PHRP Record 

| 111111 

1 2 34 56 7 8 90 1 2 34 5 

I H-H-H-l-H-H-H-l-H- 
2 I NC | CHRR 1 



CHRR NC I 

liil ~ 

l-l- 



SECONORRY ENTRY POINT 
RDDR 



NUflBER OF ENTRY POINTS 



H » Hiddtn tntry fl*9 
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Prtpartd Objtct Codt 



PHRP Record! 



Type Segnent FHRP Record 



I 



111111 
0123456789012345 

H-H-l-H-H-H-H-H-H 
| I NC I CHRR 1 I 

I i I ! 



CHRR NC I 



! 
I 
I 



-I- 



STT L£N | SEG HUH 



-I- 
SEG LENGTH 



SEGNUH 



Type 1 Procedure PHRP Rtcord 



I 



111111 
0123456789012345 
l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l- 
1 | NC I CHRR 1 
, , 



HI 



CHRR NC | 
I 1- 






SR OF CODE 
CODE LENGTH 



PRIRRRY ENTRY POINT RDDR I 
-I 



C080L TOOL BOX ID 
LINK 



i 



TOOL BOX PROCEDURE ID 
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Prepared Object Code 



SL File Forwat 



| 111111 

| 0123456789012345 
I l-H-H-H-H-l-H-H-l-H 
0| LID |0 

11 " FL 
| 

2| EL 
| 

31 

I 

4| NSEG 

| 

51 
| 

61 
I 

7| FRTL 
I 

101 



NOTE: 



LID « 4 - EXPRNOED SYSTEH SL 
« 3 - ACCOUNT OR GROUP SL 



11| NRT 

, 

121 

131 NS 

14 | NOT USED 

| 

|15| NOT USEO 

|16| YlRR I DRY OF YERR 
| | ,., 

|17 ; HOUR OF DRY I MNUTE OF HOUR 
, | 1 

1 20 1 SECONDS | TENTH OF 
i | | SECONDS 
, j 

I " 



1 FILE LENGTH (IN RECORDS) 

2 EXTENT LENGTH (IN RECOROS) 

3 

4 • OF SEGHENTS 

5 

6 

7 S.fl. OF FREE R.T. ENTRY LIST 

(-1 IF NONE) 
8 

9 « OF REFERENCE TABLE ENTRIES 

HO 

111 OF SECTIONS 

12 

13 

\ 

14 I 

I Tine rnd 

15 > DATE STRIfP 
I OF LAST 

16 I (UNIFICATION 

I 



I 



I- 



41| HASH LIST 
I • 

I 



I " 
I I- 
177| 



-I 

133 



1127 






NOTE: Uninitialized fieldt Mrt 
reserved for future use and 
ehould be zero. 
HL » Hath Liat. 
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Prepared Object Cedt 

For Croup and Recount SL 

^ 

RECORO I 

I 

I 

1 



SL file Format (Cont.) 
For Systtn SL 



NS41 



NS*2 



LAST 

REC I 



0|- 

I 
I 



RECQRO 







RECQRO 

1 



FREE MP 




1| 

I 
-REFERENCE I RECORO 

TABLE >l 1 

POINTERS | 

\ I 

\ 
\ 

\->2l 

I 
I 
I 



RECORO 
2 



1 

I 



1 

I 
FREE MRP | 
NS-1 I 

I 
1 



! 
I 






FREE I 




NS*2|- 
I 



RVRXLRBLE 



1 

I 
AVAILABLE | 



| FREE MP NS-1 
I 



NSOI 

I AVAILABLE 



LAST | - 
REC I 



AVAILABLE 



NS * Nunbtr of Stctiont 
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Prepared Objtet Codt 



Twiwl PlrKttrv S"tnr 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



I--IH--M-I 
IU IXSIP I 


NC 


-I 


-l-l-H-l-IH 
CHAR 1 


I— I— I— I— I—— 1 - ■■ 


CMR NC 






STT • 


SE6A 


IX I KP 




CN 


— — 1 -— — — 
TN 








PRRft 1 




• 


PARfl HP 



LC it (0:2)...Uvtl of Chtcking 

>« No checking 

1 >• Check for procedure typt 

2 >« Chtch for N parantttre 

3 » Chtck for ptrtntttr typt 

NP it (2:6) it N parantttre 

P - » Hot ptrntntntly allocated 
1 » Ptrntntntly tlloctttd 

U - Uncallablt bit • ttt if tntry point it unctiltblt 

KS- Tht nott tignificant bit of segment nunbtr 
> if < 256 
■ 1 if >«256 

NC- Tht nunbtr of chtrtettrt in tht tntry point ntnt 

CN- Chtrtcttr count for ptrtntttre 
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Prepared Objtet Cedt 



Storage Manaoenent 



File space it nanaged in ttmt of 128 nord blcckt (1 block per 128 uord 
record). 

Free tpace (blockt) it accounted for in a bit nap, which it partitioned into 
records (2k blocks per section) A indicated that a block is used; a 1 
indicated that it is free. 

File space is also partitioned into 2048 record sections (16 naxmun sections 
for Group and Account SLs, 32 naxinun sections for the Systtn SL; 2K blocks 
per section, one (1) nap per section). The nunber of sections in the file it 
NS * (FL ♦ 2047)/2048. The first NS records following records and 1 for 
Croup and Recount SL (records 2 ♦ NS ♦ 1) or following records 0, 1, 2 for 
Systtn SL (records 3 to NS *2) are reserved for the section napt. 

If the section naps specify nore space than is potentially available, those 
records beyond F LIMIT are narked as "USED". 



Entry Point Directory 



| 

->| LINK 
| 

I USED 
| 

I 
I 
| 

I 

I 

| 



I I 

|.> >| UNK 

I I 

| | USED 

| | 

I I 

I I 

i p- 

I I 



| , 1 

|-> >| | 

I I 1 

I | USED I 

I I 1 

I I I 

I I I 

I I 1 

I I I 

I I I 

| | 1 



The directory is partitioned into 95 Hash Lists (sane HASH function at USD; 
each Hath Litt it a linktd litt of records. 

Each record contains a successor link (record «) and a used space count. A 
LINK of terninatet a litt. When a record is void of tntries (USED * 2), 
its tpace it returntd to tht fret storagt *rt*. 

The Hash List head pointtre (HL in tht diagran abovt) are in record 0, uordt 
Z41 TO Z177. 
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Prepared Objtet Codt 



Code Setnent Linkage Structure 



CODE SEGflENT 



STT MP RRRAY 



EXTERNAL LIST 



Each code stgntnt occupies an integral nunbtr of reeordt. Thit block of 
information can bt subdividtd into three tabltt: tht CODE SEGflENT proptr, tn 
STT SEGflENT nap array, and an EXTERNAL LIST. 

STT Hao Array 

In the Systen SL, the STT flap Array it a 1 Ufifd X 256 Nord. trrty. In Group 
and Account SLs, it is a 1 by^j x 256 feyj& array. It it indexed by STT 
nu*Lir. It contains the segnent nunber which has tht tntry point 
corresponding to the external of the STT nunber. If no entry point in tht SL 
Hitches the external, each bit in the Uord (or byte) it ttt to ont. Thit 
array is used whenever the segnent is loaded and it updated uhtntvtr tht SL 
it bound oy the Seg«enter. 

External Litt 

A synbolic list of the EXTERNALS of the segnent. Each tntry eentaint 
information about the EXTERNAL: paraneter checking level and parantttr 
Nttehmg information, and the tenant nunber and STT nunbtr if tht EXTERNAL 
it satisfied within the SL. 



K 



r..i3.oo 

'.0- 15 



^s 



Prepared Object Cede 

Codt Sequent Structure (Cont.l 

I 111111 

I 123456789012345 
! --I-I-H-I-H-I-I-I-I-I-I-I-I-: 



CODE SEGflENT 



l-l-l-l 1 

SI |X| | NC I 
-l-l-l-l 1 



STT HflP ARRAY 
(SYSTEn SL*256 UOROS; 
GR0UP/ACC0UHT=256 BYTES) 



1- 

CHRR NC I 



-I- 



STT » I SEG. • 
, 1 

PI NP | CN^ 

TH 



CHRR (1) IS- SATISFIED BIT - SET IF EXTERNAL 

— | IS SATISFIED UITHIN SL 

| X - 1 IF SEW > 256 
NC - NUflBER CHARACTER IN EXTERNAL 
P - LEVEL OF CHECKING 

» NONE 

1 >« PROCEDURE TYPE 

2 >« « PARAflETERS 

3 >» PARAHETER TYPE 
NP - NUHBER OF PARAflETERS 



PRRH 1 



PARfl NP 



Prepared Object Codt 



Reference Ta ble Structure 

Each segment hat a correeponding Reference Table. 

- For Group and Account segnents, Reference Tablet are packed four (4) 
eStrie. to t record; each entry ha. a 32-uord length. To determine entry 
nunber and diaplacenent, divide segment number by 4: remainder * R T REC 
entry nunber, quotient * displacement into the Reference Table Pointer 
(lap, Record 1. 

- For System SL segments, Reference Tables are packed tuo (2) entries to a 
record; each entry has a 64-uord length. To determine entry nunber and 
displacement, divide segment nunber by 2: remainder * R T REC entry 
number, quotient * displacement into Reference Table Pointer nap, Records 
1 and 2. 

Uhtn you delete a segment, the corresponding Reference Table entry it 
released. Free entries are linked in a list. The segment nunber (link) is 
the first uord of the entry 

Uhen you add a segnent, it it attigned the firtt free Reference Table entry 
number. The tegment it attigned the next available Reference Table entry and 
space is allocated for the neu entry. 



Reference Table Pointer Hap 



Group or Account 



Svttem SL 



DREC 1 



R T REC 



EXTERNAL LIST TERMNATQR 
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0ms 



1 1 

RL 



— > 


RL 
63 





-I 
l-> 

I 
-I 



E I 

1_ I 

..... ^ 

2 I 
1 

E I 

3 I 



(FILEREC1) (1 SECTOR) 



| 

DREC1 I RL 

I I 
I 1 



I I- 



l->l E 



R T REC 
1 



I I I 



l-> 

I 
-I 



| 1 | 

I RL 127 | |- 



-I- 



DREC2 I RL 128 



RL255 I 



(1 SECTOR) 
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Prepared Object Code 



Reference Table (510 naxinum Entries) 



System 
I $L 



r 



o 

1! 
2 
3! 
4 
5 
6 
7 
HO 

17 
20 

37 

40| 

I 

I 
57 1 

I- 
60| 

I 

I 
77| 
\ I- 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

..,..|-.,..|.- | .-| : .| : .|-|-|-|-|-|-l-l-!.\ 



PI N| 



SEGflENT LENGTH 



SEGflENT ADDRESS (RECORD NO. ) 



NO. OF REC. FOR SEG AND EXTERNAL LIST 

Fill f A|~Cl~Xl"" " |N0. ENTRY POINTS 
..,.., l-l-l-l 1 

STARTING ADDRESS OF PnAP 



10 I 
I 

1 I 
I 

2 I 
I 

3 I 

4 
5 



STARTING ADORESS OF SYI180LIC INFORMATION 
.. | .. | 1 

T K I FOR tlPE/XL 6 



SYMBOLIC INFO. LENGTH 



1~ 



SEGflENT NAflE 



REFERENCE SEWENTS 

BIT HAP (FOR BOTH SYSTEfl SL 
AND GROUP AND ACCOUNT) 



> Group 
and 
Account 



EXPANDED REFERENCED 
SEGHENTS BIT flPP 
(FOR SYSTEH SL ONLY) 



RESERVED 



7 
8 

15 

116 

I 

I 

131 
-I / 

1 32 

I 

I 

I47 
-I 

|48 

I 

I 

I63 
-I 



Prepared Object Codt 



Codt Secment Uith Patch Area 



CODE 



PATCH AREA 




P»1 if the code segment contains a pri 

N«0 if tne STT is in the oli format. 

N«1 if the STT is in the neu format. 

Fsl if the segnent is deleted. 

S*1 if all exte^ai are satisfied. 

ps1 if the secment is pernai.ently allocated. 

C=1 if the segment is core resident segment. 

X=1 if the »egnent is an PPE segnent. 

T=1 if the segment contains a patch area. 

K«1 if the segnent con ins a checksum 
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leged instruction. 



PHC» "Tea 



SEGflENT NAflE 



CHECKSUfl 
PREP TIflE 



PATCH TIflE 
PATCH AREA 
PALEN 

STT 



8-UORD SEGflENT NAflE 
1-UORD UNUSED 
1-UORD CHECKSUI1 
2-UORD PREP TIflE 
2-UORD PATCH TIflE 

1-UORD PATCH AREA LENGTH 
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Prepared Object Code 
PHRP Information 




| 

| PTT 


PflAP TYPE TABLE 


| APD 


ACTUAL PHAP DATUH 


PflBP Tvoe Table 




| PTTL 
I IPSO 


TYPE TABLE LENGTH 

LENGTH OF PHAP RECORO TYPE 


1 LPR1 


LENGTH OF PHRP RECORO TYPE 1 


| LPRn 
MOTE: n ■ PTTL - 


I LENGTH OF PHAP RECORD TYPE n 
2 
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Prepared Objtct Codt 

Tvot 2 Secondary Entry PflAP Record 

| 111111 

1 2 34 56 7 8 90 1 2 34 S 

I H-H-H-l-H-H-l-H-l-H 

2 I NC | CHAR 1 | 

1 , ! 



-I- 
CHAR NC | 

HI™™*"*" 

SECONDARY ENTRY POINT 
RODR 



NUH8ER OF ENTRY POINTS 



H > HIDDEN ENTRY FLAG 
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Prepared Object Code 



PflflP Record! 

Tvoe Sequent PflAP Record 

| 111111 

0123456789012345 

I H-M-H-M-l-M-H-M-H 
| I NC I CHAR 1 I 

n "'"'"I 

i 1 1 

| CHAR NC I I 

| 1 1 

| STT UN | SEG NUH I 
, 1 j 

| SEG LENGTH I 

| 16-BIT SEG NUI1 



Tvoe 1 Procedure I 



1 Record 



I 



111111 
0123456789012345 

H-H-l-l-H-H-H-l-M- 

1 | NC | CHAR 1 
1 1 



|H| 



1- 

CHAR NC I 



-I- 



SA OF CODE 



CODE LENGTH 



PRMARY ENTRY POINT ADDR 



COBOL TOOL BOX ID 
LINK 



TOOL BON PROCEDURE ID 



G. 23.00 
10- 21 



Loader 
CHAPTER 11 LOADER 

The loader it a eysttn proem uhich Hill do loadt stqutntially. If a 
proceet needs code to be loaded, it mitt utt the nPE intrintict or connandt 
uhich uill gtt the load procttt' SIR, fill tht loadtr coimunication tablt, 
and than auaktn the loader. Upon conpletion, tht loadtr uill return itt 
•tatua through tht loadtr conmmication tablt, and than tht waiting procttt 
uill bt activattd. 



tinder Sequent Table Overvitu 

The Loadtr Segntnt Tablt eontittt of at ltatt tuo OSTt. Tht firtt out it DST 
X22 and it knoun at tht LST. Tht othtrt art knoun at LSTX data ttgntnts and 

art linktd together by a doubly linked list uith tht litt htad in tht LST. 
SYSGLOB Z226 alto pointt to tht firtt LSTX in tht chain. Tht following 
illuttrattt thit structure: 



DST 222 |— ABS (11226) 



I 1 

I LST !<- 

! 1 



i i-~ 

— >i 
i 
i- 



1 ! 

LSTX |< >| LSTX 



<—....> 



LSTX 



— I 



The prinary purpose of tht LST/LSTX data segntnt is to store directory 
tntrits, uhich kttp track of loadtd codt stsntnts in progran and SL filtt. 
Tht LST data stgnent ccntaint an additional area, knoun as ths Loadtr 
Connunication Tablt, through uhich all proctsstt in tht systtn eonmtnicatt 
uith tht Loadtr proetss. flenagerttnt of the nttsages in this area is handled 
exclusively by privileged systen code. 

Tht overall layouts of tht LST and LSTX data atgntntt are at follow: 
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Loader 

1ST Overvitu 



I- 
081 



PRIflfiRY OB RRER 



08*2 ~>l 



LOROER 



08*7 ~>| 



I TABLE 
I 



COnnUNICRTION 



SBUF (128 UOROS) 



I 

I- 
D8*0 ->| 



I 



OIRECTORY 



XLST Overvjeu 



, 

08| I 

I i 

• PRWRRY 08 AREA 



I 



I 



08*7 ->| I 

" SBUF (128 UOROS) 



08*0 ~>| 
I 



I 



1 



OIRECTORY 
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The layout* of the Pnnary 08 areas in 1ST and LSTX data accents art 

identical. However, only those uords rtquirtd for nanagenent of tht 
directory area are Maintained in LSTX data eegnents. fill other pnnary 08 
cells are defined only for the LST data tegnent. 

The purpose of the LSTXa it to provide relatively unlinited ttorage for the 

LST directory data structure. For performance (and inplenentation) reasons, 
only thote entry types related to LOflDPROC functions reside m LSTX data 
segnents. Uhen these entries need to be accessed, they are copied into 
tenporary entries in the directory of the LST data segnent. In order to be 
sure that this is possible, a naxinun-sized entry of each LOflDPROC entry type 
(LOflOPROCnRSTER and EXTENSION) is reserved in the LST data segnent by the 
Loader process. Pointers to these special reserved entries are stored in the 
Pnnary 08 area of the LST data segnent. If one of these pointers is zero, 
it neans the Loader process uas unable to allocate a naxinun-sized entry, in 
uhich case a dynamcally allocated entry of the required size nust be 
allocated for the copy of the needed LSTX entry. 

The first uord of each pemanently allocated, tenporary entry it used to 
indicate uhether or not the entry is currently in use. Zero neant it't 
available; anything else neans it't already being used to access an LSTX 
entry. Existing loader logic should not require access to nore than one LSTX 
entry of a given type at a tine. 

In order to prevent tenporary entries fron accunulatmg in the LST data 
segnent' s directory, they nust be explicitly renoved (copied back to the LSTX 
data segnent first, if nodified) uhen no longer needed. This differs fron 
LST-data-segnent-resident entries, uhich require no special logic in the 
accessing code to release such entries. Rnd this, in turn, is uhat nakes 
noving entries fron the LST to the LSTX so difficult; it's tonetinet hard to 
tell exactly uhen *n entry is no longer needed, and, therefore, is safe to 
release. 
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Loader Segnent Table Prinsrv I 



I- 



11 OIR LEN 

21 tLCT 
| 

31 ENTP 
I 

4| ENTP1 

5| ENTP2 
| 

61 ENTP3 
| 

7 1 eSBUF 

I 

101 SI 

I 

111 SJ 

121 SK 

131 SL 
| 

14| sn 

151 SN |13 

| 1 

161 SO |14 

| 1 

171 SP |15 

| 1 

2C| SO |16 

I 1 

21| SR |17 

I I 

22I SS |18 

I I 

231 ST |19 

I 1 



2 
3 

4 

5 

6 

7 

8 

9 

10 

11 

12 



24|HDFULINK(TYPE 0)|20 
25 HDFUUNX(TYPE 1) 21 

34 KOFUUNK(TYPE 8) 28 
35|H08KUNK(TYPE 0) 29 
36 HOBKUNK(TYPE 1) 30 



45 HOBKUNK(TVPE 8) 37 

46| S| LOADER 
R| RUX OS 



I- 
47 REFTRB OSTi 



38 



39 



SO j CUR • LSTX DSEGS 40 

infix • LSTX DSEGS |41 
1 

PREV LST/X OSTi |42 



53 CURRENT LST/ 
X OST I 



-I 
I43 



NEXT LST/X OSTH |44 

I 
TEHP EXT ENTP |45 



-I 



TEnP FIBSTER ENTP|46 
1 

LCT |47 
I 
I 
I 



ENTPn 
SBUF 

SI " ST 

SR 
HPPULlNKe 
hTE-KLlKKs 
REF1SB tST« 



* Pointers point to the current accessed entry 
> Utility buffer. Usually contains prog ran file record 

information 
» Utility DE relative variables 

- G?obal «y 6 ten uide flUTORLLOCRTE ON/OFF flag. 

- Head of foruard link for each type 

• Head of Lackuard link for each type 
OST r.^noer for Toe OST uhich contains all tht reference 
table entries for SL.PUB.SYS. 
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fl reference table entry in SL. PUB. SYS is 64 uords long (houever, only the 
first 48 uords art used). The data segnent only contains the 48 uordt of tht 
entry uhich art ustd to as to not uatte space. 



Pirtctorv En^et 



This section ehous tht layouts of all LST directory entry typet. Tht layouts 
given art those for permanent tntrits in the LST or LSTX. For tenporary 
entries (i.e., those entries in tht LST data segnent uhich are copies of 
tntritt uhich reside in an LSTX data segnent), the following three-uord 
prefix should bt attachtd: 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I — t — I — I — I — I — I — I — I — I — I — I — I — t — I — I — I 

I HOHE LSTX OST 41 I 

I HOtlE LSTX OFFSET I 

| 1 

| HOUE ENTRY LENGTH | 

| 1 



ENTP in tht Prinary D8 area tluayt points to tht uord afttr tht LENGTH uord 
of the entry currently bting accessed. ENTPn pointers are uttd to acctss 
othtr structures uithin tht current entry. The first three uords of 
permanent entries (or first six uorts of tenporary entries) define the entry 
header uords, and art negatively addressed through ENTP. 



I 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|--I"l--I~|--I~l--I"l--I"l"l~l--I--I~!"l 

| 0| FORURRO LINK I 

| 1| BRCKURRO LINK | 

, , 

I 21 LENGTH 

I 3| f ~ | 

| 1 1 

| 4| GARBAGE | 

| , 



6flR8R6E(0) 
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Directory Entriti (Cont.) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

l-l-l-l-l-l-l-l-l-l-l SLFIL£(1) 



l-l-l-l-l-l- 
0| FORURRO UNK 
| 

1| brckurrd unk 

I- 



LENGTH 
IXSI 

-l-l- 



4| FILE DISC RODRESS 

I- 
51 

I- 



..... ........ ^ 



61 FILE PV INFO 
I- 



7| « RLLOCRTEO SEGflENTS 

10 1 i SEGUST ENTRIES 

I- 
111 

I 

I- 



SEGRRRRV (32 UORO IF XS » 1) 
(16 UORO IF XS > 0) 

LOGICAL SEGHENT NUHBER I 

-I 



I REFERENCE COUNT 
I- 



| PHYSICAL CST NUHBER 
| 



I 
! 

I fll C| xi n| | 

I > 
1 | 

I I 
1 / 



SEGUST RRRRY 
3 UORO ENTRY 
PER RLLOCRTEO 
SLSEG 



I 



»•*•««««•«***«»«*»«•«•••«• I 



I- 



-I 



Uhert XS ■ 1 ntant tntry it for tht Extended Sytttn SL bit nap 
oF 32 uordt. 

R • 1 ntant code tegnent it allocated. 

C * 1 netnt code itgnent it core rttidtnt. 

X * 1 netnt code tegnent it an nPE tytten tegntnt. 

n = 1 netnt code tegnent it physically napped. 

= neant code tegnent it logically napped. 
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Loader 



Oirtetorv Entritt (Cont.) 



Uhtrt P * 1 neant progran it executed with NOPRIV option. 
R s 1 and fifi * ntant prognn it allocated. 
Rfl * 1 and R * 1 ntant progran it auto allocated. 
XS * 1 neant entry contains an Exttndtd Sytttn SL bit nap 

of 32 uordt. 
S = 1 neant thit bit nap it for tht Exttndtd Sytttn SL and 
contain* 32 uordt. 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

M ..,..,.-|..|..|-.|..|..|..|..|~|~|-.|--l~! 

01 FORURRO LINK I 

| j 

1 | BRCKURRD LINK I 



LORDINGO) 



i-r 



I- 

21 LENGTH 
l-l 

3|P ' .- 

4| FILE DISC RODRESS 

I- 
51 

j 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

i — i — i — i — i — i — i — i — i — i — i — i — i — i — i — i — j 

0| FORURRO LINK 



BRCKURRD UK* 
LENGTH 



11 

I- 
21 

,.., 

3|P I 
l-l 

4| FILE DISC RODRESS 

1- 
51 

| 

61 

I- 
71 

I- 



I 4 



URITING PIN 
UNUSED 



UAITER(4) 



G.23.00 
11- i 



Directory Entritt (Cont.) 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



|--|-|~I"I--I~I"I"I-I~I"I--M~I"I- 
01 FORURRO UNK 



1| BRCKURRD UNK 
| 

21 LENGTH 



l-l -I- 1 -I 1- 

3|P |fl IXSIRRI UB I 
l-l-l-l-l 1- 

4| FILE DISC RODRESS 

I- 
51 



| 

61 CST BLOCK INDEX 



I- 
7| SEGflRP DST 



I- 

101 N PROCESS SHRRING 
| 1 

111 i SEG IN PROGRflfl | N SUNFO RRER 

I FILE I 



I- 
121 PV FILE INFO 



-I- 



I- 

131 TRRCE EXTERNAL PLRBEL 
|.., 

14 IS | SL SEARCH SEQUENCE 
,..! 

151 SL FILE DISC ADDRESS 

I- 
161 

, 



I 17| 



I UB SEG RRRRY (16 UORDS) 



, 

| PSEGHRP SIZE 

I UB LOG SEG (9 BITS) I SL INFO INDEX 
, 1 

I UB LOG SEG (9 BITS) I SL INFO INOEX 



I UB LOG SEG (9 BITS) I SL INFO INDEX 
, 1 

G.23.00 
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PROGRRH 
FILE (2) 



^ 



\ 

I 
I 
I SL INFO RRER 

> 35 UORDS FOR 
I SYSTErt SL 
| 19 UORDS FOR 
| GROUP RND 
I RCCOUNT SL 
I 



PSEGflRP 



^ 



Directory Entriet (Cont.) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
-I— I— I— I— I— l—l— I— I— I— I— I— I— I— I' 

FORURRO UNK 



BRCKURRD UNK 



2 LENGTH 

-I 

3P I 
.-| 

4 FILE OISC ADDRESS 
5 



6 LOAD PROCESS STATUS 
7. 



L0R0ED(5) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I — I — I — I — I — I — l^r-l — I — I — I — I — I — I — I — I — 
0| FORURRO UNK 
, 

1| BRCKURRD UNK 
I- 



21 LENGTH 

l-l— ■ 
3IP I 

l-l — 
4| PIN 

I- 
51 FILE OISC ADDRESS 

I- 
61 

| 



-| 



SKRRER(6) 



^Hk 
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r 



notary Entries (Cont.) 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



l-.|~l~l"l"M~l~M"M~M-M 
01 FORURRD LINK 



I- 
1| BRCKURRD LINK 



I- 
2 1 LENGTH 

| 1 .. | .. | 1 -« 

3| IXSISOI LIB I 7 

| 1.-| — | 1 

4 1 PIN 



I- 
5 1 EXTENSION 10 

61 LOROPROC COUNT (LOROPROC) / 
| LOG SEG N (RLLOCRTEPROC) 



7| PLRBEL 
I 

101 i CHRR IN NRRE 
I 

' PROCEOURE NRHE 



..| 1- 

S I SL SERRCH SEQUENCE 



•I 

I * SL INFO RRER 



-I- 
SL FILE DISC RODRESS 



LIB SEG RRRRY (32 UORD IF S * 1) 
(16 UORD IF S « 0) 



HCSTREFSIZE 

-I 

N I 

-I 



| nCST INDEX (1) 
-I 



EXTENSI0N(7) 



UonJ contains 
LOROPROC count, 
if entry uas 
created by 
LOROPROC. 
Uord contains 
logical segment 
nunber, if entry 
uas created by 
RLLOCRTEPROC. 



| SL INFO RRER 
| 35 UQRDS FOR 
I SYSTEH SL 
I 19 UORDS FOR 
| GROUP RNO 
I RCCOUNT SL 
I 
I 



l-l- 
IN I 
M- 



| HCST IKDEX(n) 
-I- 



\ 
I 
I 

> HCSTREF RRRRY 
" I 
-I I 
I / 
-I 



XS * 1 mans entry contains an Extended Systen SL bit nap 

of 32 words. 
SO * Search Donain 

* 1 neans use progran group and account for library search. 

* neans use log on group and account for library search. 
S ■ 1 neans this bit nap is for the Extended Systen SL and 

contains 32 uords. 

G.23.00 
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Loader 



loader Cache, 



SYSGLOB extension area ♦ Z72 contains OST mmber of cache 
BUCKETSIZE « X52 

Cache Data Seenont Fornat 

I- 
01 
1 | HIT COUNTER 



4* BUCKETSIZE 



I- 
21 
31 HISS COUNTER 

4| BUCKET 

I 

I BUCKET 1 

I 

I 



I- 
4*94* BUCKETSIZE I 



4*95« BUCKETSIZE -1 I 



I BUCKET 94 



Bucket Fornax 

1 



—...-..-.——I 


LENGTH OF 
SLDIR1 ♦ 1 




SLOIR 1 


LENGTH OF 
SLDIR2 ♦ 1 


SLDIR 2 


————-—- 



HOST RECENTLY REFERENCED SYSTEH SL 
DIRECTORY ENTRY FROH THIS SL DIRECTORY 
BUCKET 



SECOND HOST RECENTLY REFERENCED ENTRY 



| 1 

| LENGTH OF | 

I SLDIRN ♦ 1 | 

| 1 Nth HOST RECENTLY REFERENCED ENTRY; IF 

BUCKET I SLDIRN I NOT COMPLETE THEN INDICATES END OF 
SIZE-11 1 BUCKET 

fill bucket uords »n initialized to BUCKETSIZE ♦ 1. indicating 
no entries. 
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Loader 



Directory Entnea (Cont.) 



I o 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
, — |--l — | — | — I — t — I — I — I--I — I — I--I — i — I — 

| 0| FORURRD LINK 



I- 
1 | BRCKURRD LINK 

2 1 LENGTH 



I 8 



4 1 PIN 



-I- 



5 1 N SLID ENTRIES 
, 1~ 

61 

" EXT IDX TRBLE (16 UORDS) 
25~ 

| 



I « ACTIVE LORDPROCS 



26| 
45" 



HCST IDX TRBLE (16 UORDS) 



46I SLID(1) 

| DISC RDDRESS OF SL 
, 

I 



I I- 



I 

I SUD(n) 
| 

I 

I 

I 



-I- 



I N HCST LOGSEG SIZE 
., 



-I- 



! | LIB LOG SEG (9 BUS) I SL INFO INDEX 



I I- 



I REFERENCE COUNT 
| 

I 



| 

I LOG SEG « 
I- 



| REFERENCE COUNT 
I 



I SLID INDEX(n) 
-I 



LOROPROC 
flfl$TER(8) 



\ 

I 

I 

I 

I REFERENCED 

> SL RRRRY 

I 2 UORDS 

| PER ENTRY 

I 

I 



HCST LOGSEG 

RRRRY 

2 UORDS PER 

ENTRY 
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Loader Connunication Table (LCT) 
Fom Inconing to Loader (Load/Rllocate Progran) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

— I — I — I — 1 — I — I — I — ■ — I — I — I — I — I — 1 — • — I 

CH0 I LIB I n|LD| L| I 

— I- — l-l-l-l-l 

PIN 

LDEV I 
1 

DISC RDDRESS 



UNUSED 



I 
I 111 



I 
121 

131 

14 

15 

16 

17 

20 

21 

22 

I 23 

I 24 



URITER PCB INDEX 



-l-l-l-l- 
IBRIIRIPnl 



|HR| 
-l-l- 



IOSIPH 
-l-l 



GROUP 
NfiflE 



CRD * loader end 

* load prgn 

1 * load proe 

2 * alloc prog 

3 « alloc proc 
LIB * library search 

« SYS 

1 « PUB 

2 = GROUP 

H « NON PRIV RODE 

LD « LORD DOHRIN (FOR 

LOROPROC) 

"USE LOGON GRP 

& RCCT SLs 

1 *USE GROUP & 

RCCT SLs UHERE 
THE PROGRRH 
RESIDES 
USER CAPABILITY 



RCCOUNT 
NRHE 



I- 



I 25 | °V IM^O 



I- 
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LaarfT Cnnminication Table (LCT) (Cont.) 
Forn Inconino to Loader (Lo «d/Rllocate Procedure) 



1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 
H .. MHH ..,~|"I-I"I-|-I-I-|-I~ 
WO I LIB I HILDI LI I 

PIM 




51 
I 
6 | PROCEDURE NRRE 

I 

7| 

I 

101 

I 

111 

I 

121 

I 

131 URITER PCB INDEX 



NflflE 



I- 
14| 

I- 
151 

I 
161 

I 
171 

I 
201 

I- 
211 

I 
221 

I 
231 

I 
241 

I 

251 PV INFO 



•l-H-l l-l-l-l- 

IBRIIRIPni |flR| IDSIPH 
-l-l-l-l l-l-l-l 



ACCOUNT 
NRflE 



I- 



CnO * loader end 

s load prgn 

1 = load prcc 

2 « alloc prog 

3 * alloc proc 
LIB « library search 

■ SYS 

1 « PUB 

2 « CROUP 



n * NONPRIV RODE 
LD * LORD DOnflIN 
L « LORD flRP REQ. 



USER CRPRBIUTY 
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Loeical Sjasenj Trantfom Table (LSTT) (Cont.) 



« OF L06ICRL SEGflENTS 
LENGTH OF LSTT 
PHYSICRL SEGflENT I 
POINTER TO STT UST 
PHYSICRL SEGflENT I 



POINTER TO STT UST 



PHYSICRL SEGflENT • 

POINTER TO STT LIST 

fl| STT • | SEG • 

-I 1- 



ni STTI 

I— • 



I SEGA 

-I- 



fl| STT • | SEG • 

TOTRL STT'S FOR THIS SEG 



I LOGICAL SEG 1 
v 

I LOGICAL SEG 2 



I LOGICAL SEG n 
v (flAX 255) 



I STT'S FOR LOGICAL 
v SEGflENT 1 
(IF NEEDED) 



HI STT • | SEG • 

|n| STT • | SEG • 



l-l- 

|fl| STT « 

H- 



~l- 
I SEGA 



-I- 
\~> | TOTRL SST'S FOR THIS SEG 



I- 



STT'S FOR LOGICAL 
SEGflENT n 
(IF NEEDED) 
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Loader Connu mcation Table (LCT) (Cont.) 



Forn Returntd (No Error) 



| .. , .. | 

Olfl |flF| STRRTING SEGflENT NUflBER 
, .. | .. | 

11 



21 LORD flRP FLAG 
I 

3| LDEV 
I 

4| DISC 
I I- 
5| RDORESS 



61 TRRCE LABEL (IF TRRCE) 
! 



s**^!x 



Forn Returned (Error Occurred) 



j 

01 FILE SYSTEfl ERROR A 

1 | LOADER ERROR « 
, 






Logical Se<ment Tranoforn Table (LSTT) 

Uhen a process references any user SL segments, these segnents *n assigned 
logical segnent nunbers if the neM napping ucode is running. The LSTT 
provides a nap napping these logical segnents into their physical segnent 
nunbers and having true STT's for the napped segnents. The LSTT is created by 
LOADER during the load tine. It occupies an DST and the DST nunber is stored 
in PCB(Z17). If no user SL segnent is referenced, the LSTT will not be 
needed, hence it uill not be created. 

The neu napping nicrocode depends on the existence of the LSTT for getting 
the physical segnent nunber for a napped segnent. So the LSTT has to be 
included in process' locality list if there is an LSTT. Dispatcher uill then 
bring the LSTT in before the process can be run. Rlso the bank and address 
for the LSTT belonging to the current running process are stored in sysglob 
cells (Z221 and Z222) during the launch tine by the dispatcher. These cells 
are used by nicrocode for fast accessing the LSTT. 
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Loader 



tWAr SatUaiD! P*te Seonen^ 



The loader auxiliary data eegnent is a nulti-table data segnent. Each table 
uithin the data segnent hes a standard header and they *n linked together 
via DB relative pointers. 

Tables uithin the loader auxiliary data segnent are the: 

1. Autoallocate table 

2. Progran nane table. 



Loader Ruxiliarv Data Segnent Fomat 



/O 
I " 
I 1 
I 

I 2 
I 

I 3 
Table -I 
Header | 4| 
I 

I SI 
I 

I S| 
I 
\7 



/O 
I 

I 1 
I . 
I 21 
I 
I 3| 



TABLE SIZE 

ENTRY LENGTH 

TOTAL NUflBER FREE 

FIRST FREE 

DB RELATIVE POINTER TO TRBLE TUO 



UNUSED 
UNUSEO 



AUTOALLOCATE TABLE 



TRBLE SIZE 



ENTRY LENGTH 



UN-.«?EO 



UNUSED 
Table -j I 

Header | 4| DB RELATIVE POINTER TO NEXT TRBLE 
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Table i 



Loader Auxiliary Data Se anent Fornat (Cont.) 



/^ 




Autoallocate Table 



Overview 



The autoallocate table it a table to aid in the autonatic allocation/ 

deallocation of prograne. It it a leatt recently uted list of progrant uhich 

*rt not being uted at the nonent and thut are candidatet to be automatically 
deallocated. 

fi*tnr Con^en^t 

Each entry it a OB relative addrttt of a progran file entry in the loader 
tegnent table (1ST). 

Rutoallocate Table 



01 LEAST RECENTLY USEO ENTRY 



I HOST RECENTLY USEO ENTRY 
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/* ' *\ 



Progran Nane Table 



Overvieu 

The progran nane table contains the fully qualified file nanet and the due 
address of all progrant currently loaded in the tytten. The nane of a 
progran can be found by indexing into the progran ntnt table uith the tane 
index used for the CSTX block table. This index can be found m the PCB and 
in the progran entry of the LST. 

Uhen a progran it loaded, itt nane it entered into thit progran nane table. 
However, uhen it it unloaded, it it not renoved. Thut the progran nane table 
entry "x" uill contain the nane of the progran uhich it currently allocated 
to the corretponding CSTX block index. If the corretponding CSTX block 
index it free then the contentt of the progran nane table it the progran 
uhich uat last allocated to that index. 

NOTE: Entry of the progran nane table it uted by the loader at a 
tcratch area tmce there it no legal CSTX block index of zero. 



, 1 

0| 10 

I I 

1| PAOGRRR |1 

I I 

21 NARE 12 

I ! 

31 13 

| 1 

4| 14 

I I 

S| PROGRRR 15 

I I 

6| GROUP 16 

I I 

71 ! 7 

10| ~™~ ~ 18 

I I 

11| PROGRRH |9 

I I 

121 RCCOUNT 110 

I I 

131 111 

14| FILE 112 

I DISC I 

151 RDDRESS |13 

161 UNUSEO 114 

| 1 

17| 115 
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Private Volunet/Scrial Diae 



Private Volunet/Serial Oitc 



CHAPTER 12 PRIVATE VOLURES / SERIAL DISC 
Hounted Volune Table (RVTRB) 



DST * 53 * Z65 

SIR * 27 » Z33 



111111 
0123456789012345 
H-H-H-H-M-H-M-l-H 
0| ENTRY SIZE I RAX ENTRIES |0 

1| « OF ROUNTED VOLURE SETS |1 

21 LDEV | DIR8ASE 1 2 
| 1 -| 

31 OF SYSTEn VOLURE SET |3 

4| |4 

51 |5 

, 1 

I I 



HASTE* VOLURE OF 
SYS VS IS ALURYS 
LDEV ■ 1. 




ENTRY 
(nVTABX > 



Nounted Volune Table (RVTRB) (Cont.) 



OIUI CYCLI 0IRCSI2E/32 |0 

|.| 1 1 1 | 

11 KVOL | NVOL I 11 I 

2 1 LDEV | DIABASE |2 RASTER VOLUflE I 

| 1 | OF VOLUNE SET | 

3 1 OF VOLUNE SET 1 3 IS ON THIS LDEV I 

4 | UCNT |4 

5 | GENERRTION NURBER I 5 I 

, 1 1 \ | 

6| LDEV | VTRBN |6 I I 

| 1 1 > - VOL ENTRY > ENTRY 1 

7 | VCNT |7 | (DOUBLE) I (RVTRBX * 1) 

, 1 / | 

f I I 



I 
-I \ 

120 I 

-I >■ 

121 I 
-I / 



24| LDEV 

251 VCNT 



VTRBX 






• VOL ENTRY 7 | 
(DOUBLE) v 



/-""•^Si-v.. 
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ENTRY n - 1 
(RVTRBX » n - 1) 



| 
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Privatt Voluntt/Strial Oitc 



nounttd Volu nt Tablt (flVTRB) (Cont.) 



I l-l- 



-I- 



0|U| CYCLI 
|-| 1 

ii hvol I hvol | 

I 1 1 

21 LDEV | 
| 1 



DIRCSIZE/32 
I 



OIRBRSE 



31 

I- 
41 



OF VOLUflE SET 



UCNT 



GCHERflTION NUflBER 



61 

I- 
71 

I- 

I 



LDEV 



VCHT 



-I 

10 
-I 

11 
-I 

12 

I 

13 
-I 

14 
-I 

15 



VTRBX 



• VOL ENTRY 
(DOUBLE) 



I 24| 



LDEV I 

I 1 

25 1 VCNT 



I 



1 \ 

VTRBX | 20 I 

| > - VOL ENTRY 7 

121 | (DOUBLE) 
1 / 



- ENTRY n 
(ITVTRBX « n) 



U -InUstd) 
Not Uttd (0) 

CYCL - Cyclical volunt indtn 
(local VTRBX) for disc 
tpact allocation 

HVOL - Highttt (ordinal) volunt 

index (volunt index btint tht 
volunt ttt't local VTRBX) of a 
nounttd ntnbtr of tht volunt 
ttt (data) 

HVOL - * of voluntt nounttd for tht 
volunt ttt (elatt) 

UCHT - * of uttrt having nounttd 
tht volunt ttt 

VCNT - * of uttrt having nounttd 
tht volunt. 
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Privatt Voluntt/Strial Ditc 
Privatt Volunt Ua.r Tablt f PVUSER) (Cont.) 



I 26 

I 27 

I 30 

I 31 
I 32 



SYSTER BIND COUNT 
SYSTEH ItOUNT COUNT 



BIND NRHES COUNT 



DST N OF BIND NflflES 
SEGflENT 



22 > - USER EHTRY 
I 2 

23 I 
I 

24 I 
I 

25 I 
126/ 



VTiflSK 

PIN 

USER BIND COUNT 



USER HOUNT COURT 
SYSTEH BIND COUNT 



SYSTEH HOUNT COUNT 



BIND NRHES COUNT 



DST N OF BIND NRflES 
SEGflENT 



\ 
I 
I 
I 
I 
I 
I 
I 

> - USER ENTRY 
I n 

I 



—I 



1 


•.J— 


1 


| OP flRSK 


1 


HVTRBM | 
............ 1 


i 

1 
i 

1 
1 
1 
i...... — — 


— I — 

R 
V 
R 
I 
L 
R 
B 
L 
E 


............ | 

1 

- 



| VOLUHE SET 

> - ENTRY n 

| (rWlRBX * K) 
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Privatt Voluntt/Strial Ditc 



I 



0123456789012345 

l-H-H-H-M-M-M-M-H 
| 0| TABLE SIZE (UOROS) 10 

| 1 

| 1| I OF ENTRIES M 

| 1 

| 2| BITHRSK OF HVTRBX'S 12 

I REPRESENTED I 
1 

I 3j nflxmun trble size (uords)|3 

RVfllLflBLE POINTER 14 
1 1 

OP nRSK | HVTRBX |5 

1 1 

HRX USERS 16 

1 

N PINt 17 

I 



Privatt VolM "» "«r Tablt (PVUSER) 

DST - 54 (Z66)/SIR * 29 (235) 
111111 



^ 



> - TRBLE HERO 
| (5 UOROS) 



I 101 
I 11 
I 12 
I 13 
I 14 
I 15 
I 16 
I 17 
I 20 
! 21 

I 22 
I 231 
I 24 
I 25 



CURRENT SIZE OF ENTRY 



PV FLRGS 
VRRSK 



-I- 



PIH 



USER BIND COUNT 
USER ROUNT COUNT 
SYSTEn BIND COUNT 
SYSTEH HOUNT COURT 
BIHD HRHES COUHT 



DST N OF BIND NRHES 
SEGHENT 

VflflSK 

PIN 

USER BIHD COUHT 

USER HOUHT COUHT 



18 I 

. -I I 

IOP 19 / 
-I — I 

110 \ 
1 | 

HI I 
1 | 

112 I 
1 | 

113 I 
1 | 

|14 >■ 
1 | 

MS I 
1 | 

116 I 
1 | 

117 I 
! / 

1 

118 \ 
1 

119 
1 

_ ,2 ° 
• |21 



EHTRY HERO I 
(5 UOROS) I 



USER ENTRY 

1 



> - VOLUflE SET 

| ENTRY 1 

| (HVTRBX > J) 



-I 
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Privatt Voluntt/Strial Ditc 



Bind, Nanff Da^a ftgntnt 
(Crtattd and nanagtd via PVUSER Tablt) 



111111 

0123456789012345 

l-l-H-l-l-l-H-l-H-l-l-H-l 

0| HRX SEGflENT LENGTH |0 



I- 



-I 



1| CURREHT SEGflENT LENGTH |1 
| 1 

2| |2 

I 1 



I 
I 
> - EHTRY 

I 
I 



10 

1 
2 
3 
4 
5 
6 
7 

10 



BIND COUHT 



GROUP HRflE 



RCCOUHT NRnt 



> - EHTRY 1 



*"•> 
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Private Volunes/Serial Due 
Bind Nanes Data Segnent (Cont.) 

I 



I 



BINO COUNT 



CROUP NfiHE 





16 


ACCOUNT NfittE 


-1 




17 




18 
j 


R 


1 


V 


1 


fl 


1 


I 




L 




fl 




B 


" 


L 


1 


............. 


1 
. 1 
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End-of-Fila Fornat 



Files atart on a factor boundary, and and on on*. The End-of-File eenaifta 
of a racord length and O-fiil to the end of the current sector as folloue: 



RLRL 



RLRL 



RL I 
1 



ZERO FILL 



SECTOR n 



Rn End-of-File entry is nade in the Gap Table, so that files nay be skipped 
by scanning Cap Table entries instead of serially scanning the data area. 
Sefer to "Cap Table Fornat" in this chapter for detailed information. 



r 
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Serial Disc Tahiti ind Dat a Structures 

Data Record Forwat 

The prinary purpose of the Serial Disc Interfacs (SDISC) is to adapt the 
undefined length transfers characteristic of nagnetic tape to the 
fixed-length environnent of a disc or cartridge tape (CTRPE). To acconplish 
this, data is buffered uithin SDISC. The buffer is an integral nunber of 
sectors (blocks for the CTRPE) long. Files aluays start on a sector 
boundary, but data records uithin files n*y start anyuhere and straddle 
sector boundaries. R record in the buffer is structured as follows: 



-I- 



| RECORD | 
I LENGTH | 
I (BYTES) | 
| 1- 



DRTR 



■-I 1 

I RECORD I 

I LENGTH | 

I (BYTES) I 

-I 1 



The record length is aluays a one-uord positive byte count uhich includes 
only the data portion of the record, not the length uords thenselves. Records 
uithin a file night be stored on the disc as follous: 



...., .-- 

RL I I " 

..„, ,_|— -| j 

I RL | RL I I I 

1 l-l-l-l I--I SECTOR n - 1 

I RL | RL | I I 

1 1 |-| | 

I v 

"TrTTrVi I 7 

..., l-l-l-l 1 

I RL I RL | I I 

1 1 1| 1 1 SECTOR n 

I RL I RL I I 
1 1 1 | 

I v 

"™| RL I RL I I 

, , 1 1 



The reason for the trailing byte count is to inplenent an easy uay to 
backspace records. 
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Contiguous Block Fornat 

R serial disc can perform all the tatke that a nagnetic tape can do. It can 

also be a coldload device. The nachine nicrocode nust be able to read a 
bootstrap ehannel pregran and the resident eegnente of INITIAL f ron the disc 
into nenory. The nicrocode and channel prograns cannot interpret the record 
length uords uhich surround standard data records. R structure, called a 
CONTIGUOUS BLOCK, uhich has the data uithout the length uords is utilized. 
Infomation as to the length of each contiguous block is stored elseuhere. 
Entries in the Gap Table hold the beginning and ending sector addresses of 
each contiguous block. Each block nust begin and end on a sector boundary. 
To distinguish contiguous blocks f ron nornal data, a record length and a fill 
character of X1 77777 is used, as follous: 



PREVIOUS RECORDS 



RL | -1 
1 



-1 FILL 



CONTIGUOUS BLOCK 



|— 



-1 FILL 



SECTOR n - 1 

I 



SECTOR n 



SECTOR n ♦ 1 

I 



Ml F 9™ft 

Holes on the serial disc have the sane fornat as contiguous blocks (they 
etart and end on sector boundaries uith -1 fill characters as required). 
Starting uith fJPE vereion G.00.00, holes are ofcsclete and SDISC uill not 
generate then. Houever, code has been left in SDISC *.; process any holce 
found on serial discs untten uith earlier versions of SDISC. Further 
detaile nay be found in the Serial Disc MS. 
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Gao Table Fornat 



Tht Gap Tabic it a four-uord header folloutd by a strict of two-word device 
addrtts entries. A pernantnt copy is on the device, starting in tector 4, 
uhilt a working copy it in mm ncnory. The copy in ntnory it posted to the 
disc only when a backspace or reumd operation occurs after writing (uhen the 
copy in nain nenory has changed). The length of the Cap Table is 
device-dependent according to the table belou: 



Device 

HP 7920 

HP 7925 

HP 7933/35 

HP 7902/9895 

HP 35401 /HP 9110/HP 9144 

HP 35401 /HP 9110/HP 9144 



Hunber ot Sectors (or CTRPE blocks) 

44 

106 

219 (250 for G.00.00 and later releases.) 

26 

4 blocks ("S" cartridge) 

15 blocks ("L" cartridge) 



The following is an illustration of the Cap Table: 



| 111111 

| 0123456789012345 
I M-H-M-H-l-H-M-H-H \ 

0| SECTOR AODR OF LORD POINT | | 

11 UNUSED I I 

2| UHUSED | > - MP TRBLE HERDER 

3| UHUSED I I 

| | 1 j / 

I 4| TYPEI I 

I | | SECTOR ADDRESS I ENTRY (2 WORDS) 

5 > ! 

I 6| TYPEI I 

I | 1 SECTOR RDDRESS I ENTRY (2 UORDS) 

71 I 



The eight possible 
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The type field is bits 0. 1 and 2 of tht first uord. 
types art: 

0. END-OF-FILE. The associated sector address contains ont op nor* 
tnd-of-filt fill character* (0) to fill out that sector. If the record 
endt exactly at a ttctor boundary, tht following tnd-of-file ttctor 
containt all 2 trot. 

1. END-OF-DATA. Tht associattd ttctor addrtss is tht latt addrtts of valid 
data plus 1, (tht next available address). Such *n entry is usually 
preceded by an end-of-file entry. The EOD entry is untten uhen unting 
teminates. The file tysttn uill not backtpact or rewind afttr writing 
without ttndmg a URITE ENO-OF-FILE. Rn EOD tntry it alto uritttn at the 
beginning of the Cap Table when new (unwritten) nedia it inttrttd. This 
prevents erroneous reading of blank nedia. 

2. BEGINNING OF HOLE. The starting address of a defective arta of the ditc. 
It it utually found on a track boundary, but nay be in md-track if a 
contiguous block was being wntttn uhen tht defect wat encountered. 
Obsolete, starting with flPE vtrtion G.00.00. 

3. END OF HOLE. Tht corrttponding tnding addrest of the defective arta. It 
it alwayt found at a track boundary. Qbtolete, starting with HPE vtrtion 
G.00.00. 

4. BEGINNING OF (CONTIGUOUS) BLOCK. Tht starting address of a contiguous 
block, exclusive of tht -1 fill chsracttrs which nay havt bttn rtquirtd 
to gtt to a ttctor boundary. Unlikt the End-of-File fill characters, 
thtrt netd not bt any -1 characttrt if tht previous record or contiguous 
block (with or without tht trailing length word) ended exactly on a 
ttctor boundary. 

5. END OF (CONTIGUOUS) BLOCK. Tht addrttt of tht latt ttctor containing 
contiguout block data. Tht ttctor nay alto contain -1 fill characttrt to 
gtt to a tector boundary, but at with tht btginning of block thty arc not 
rtquirtd if the contiguout block tndt exactly on a ttctor boundary. 

5. END OF TRPE ITRRK. Tht tector addrttt of tht tinulattd End-of-Tape 

reflector. Thit type it now writttn only to floppy ditcs for ust by tht 
INITIRL ttrial ditc inttrfact. Uhtn read by the HPE SDISC, it it tkipptd 
no natttr what dtvict it it found on. Thit tnturtt compatibility with 
older serial discs. 

7. END OF GAP TRBLE. No attociattd ttctor addrttt. Thit typt it created 
whenever the Gap Table it cltared, by initializing the tabic to -1. 
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SDISC Extra Data Seawents 



Private Voluntt/Strial Dite 

Tht txtra date ttgnent is organized at follow*: 



Uith feu exceptions, SDISC operates entirely in tplit-ttack nodt uting an 
extra data ttgnent for working storage. Starting with I1PE version G.00.00, 
there arc two additional data segncntt used at no-uait data buffer*. For tht 
nost part, the discussion here it restricted to the original data ttgnent, 
now uttd only for variables, tht Gap Table, and data buffer nanagencnt. 

The working ttoragt txtra data ttgnent (XDS) it utually acquired by tht 
txttrnal procedure ALLOCATE uhtn the ttrial ditc dtvict it first attigntd to 
a uter at part of an FOPEN. Tht txttrnal procedure DEALLOCATE releases the 
XDS in procttsing tht final FCLOSE againtt tht dtvice. The tytttn pregran 
PVPROC nay alto acquire and release an XDS to allow the tape label routine* 
in LRBSEG to utt SDISC uhtn DEVREC processes a dtvict on-lint interrupt. 
SDISC allocattt the two data buffer ttgntnts as they arc needed, then 
releases then at part of tht Dtvict Clett proctdure. 

The XDS containt tht global ttoragt arta for SDISC, including tht data buffer 
nanagencnt area (BUFFER' INFO), and a tnall buff tr (called UORKTABLE). The 
conttntt of tht Strial Ditc labtl ttctor it ttored in UORKTABLE when it ie 
read in by SOISC as part of the self-configuration. The Ocfcetive Track* 
Table (HAC fanily discs) or Defective Sector Tabic (CS80 discs) is also 
stored in U0RKTR9LE while tutptct or dtltttd traekt arc being reattigntd. 

The three arrayc in the XDS (UORKTABLE. BUFFER'INFO and CPT (Gap Table)) art 
dynanically configured by SDISC at indirtct •my: Tht trrty nanet »n 
declared at pointtrt, thtn appropriattly conputtd elenent-0 addresses art 

inttrttd in thtn. 



I 01 
I 1 



1 2 

I 31 

I « 

I 5 

I 6 

I 7 

I 10 

I 11 

I 12 

I 13 

I 14 

I 15 
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UORDSPERSECTR 



SECTORSPERTRRK 
STARTADORESS 



EOTSECTR 



EODSECTR 

JUSTALLOCATED 
URXTERING 
FATALERROR 
VOLUHE' FATAL 
KON'VOL'SPECIFIC'FLRCS 
RAX'DSEC'SUE 
SOISC 

UORKTABLE 
BUFFER' INFO 



GAP TABLE 



SinULATED BECINNINC-OF-TAPE 
3 SinULATED END-OF-TAPE 
4 

5 LAST SECTOR OF DISC 
6 



10 
11 



12 
13 



X*s^v 
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The first thirteen words art reserved for use when the data segnent it 
created. The first seven uords are fiiled with infomation taken fron the 
label sector, and the last six »rt filled by ALLOCATE. 



UOROSPERSECTR 

SECTORSPERTRflK 

STARTADDRESS 

EOTSECTR 

EOOSECTR 

JUSTBLLQCATED 

URITERING 

FRTALERROR 

VOLUHE' FATAL 

NON'VOL' SPECIFIC FLAGS 

WWDSEG'SIZE 

SDISC 

UORKTABLE 

BUFFER' INFO 

CAP TABLE 



Uords per sector 
Sectors per track 
Sinulates Beginmng-of-Tape 

- Sinulates End-of-Tape 

■ Sinulates tape runoff 

Initializes SOISC paranetert to BOT if true 

■ Sinulates tape urite ring 

• Disables SOISC pemanently uhen true 

■ Disables SDISC until a neu volune is nounted uhen 
true 

• SDISC global flags that are non-volune specific. 

• Haxinun size of the XOS 

- Global variables, including »my pointers 

• Length is 512 uords 

- Length is calculated as: 
flAK'Ntm' BUFFERS (currently 2) 
INFO' ENTRY' SIZE (currently 8) 

- Length varies uith device - is calculated by the 
SDISC routine as part of self-configuration 
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CHAPTER 13 I/O 
I/O Table Linkage 



I/O TABLE LINKAGE 




* DRQ for disc requests 



Private Volunes/Serial Disc 

Serial Due Organization 

The disc is organized as follous: 

| LABEL SECTOR |0 See expanded vieu in Chapter 3. 

! DTT/DSc" " M DTT (HAC fanily) or DSCT (CS80). 

| COLD LOAD 1 2 HP-IB cold load channel prog. 

| 1 

| SOFTDUHP 1 3 SOFTDUhP channel progran. 
| 1 

| GAP TABLE |4 TO STARTADDRESS - 1. 

U i 

| DATA I STARTADDRESS 

i : ! : 

I . I TO 

I I 

| | EOTSECTR 

| 1 

I I TO 

| 1 

| LAST DATA SECTOR I EODSECTR 
| 1 
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Device Reference Table (DRT) 



HP-IB SYSTEHS 
UBS | 

Z10| BANK OF DRT 



I 



-I 
I \ 



Z11j OFFSET OF DRT IN BANK | / 
| 1 



ORT ENTRY ON /33, /44 
SIOP 



1 



DBI 
PI 



CHANNEL FLAGS 



1 

I 
1 



l< / 



-I 



SIOP - Absolute address of SIO progran. 
PI - Interrupt handler PLABEL. 
DBI - This is the absolute address of the ILT. 



Driver Linkage Table (DLT) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
-1 — I — I — I — I — I — I — 1 — I — I — I — I — I — I — I- 



JDFinCiCRi 10 IBTYP 
QUEUE NUHBER I (SEE BELQU) 
I--I--M l-l 

HONITOR PLABEL 

INITIATOR PLABEL 



COflPLETOR PLABEL 

INTERRUPT PLABEL 
1 

DIT SIZE I DEVICE TYPE 

CS DRIVER EDITOR PLABEL 
INITIALIZATION PLABEL 



DPROC 
DhNTR 
DINIT 
DCORP 
DINTP 
DTYPE 
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Thtrt it one DLT for eaeh typt of drivtr. A pointer in the OIT allows 
different devices on a controller to have different driven and 
interrupt handlers. 

DPROC.flNURB - This field contains the I/O process request ^unutt 

nunber for type 2 drivers - zero for all other types. 

.(S:1).DRVRFRZN - Driver code frozen - set by RAH uhen the driver 

(DF) code segnent has been nade present and frozen fron a 
request fron SIODfl. 

.(9:1).RflnERRQRC - RAH Error on Code Rakepreaent. 
(BC) 

.(10:1). COHERES - If set both initiator and cenpletor code are core 
(CR) resident. 

.(14:2).DRVRTYPE - DRIVER/nOMTOR TYP£ 
(MVP) - Mot used. 

1 - Driver can be executed on any stack. 

2 - Driver can be executed in the user process or 

in the I/O process identified by IDNUR8. 

3 - Run only in process uhose PCB nunber is in 

idnurb. 

DltNTR - I/O Ronitor PLABEL. 

DINIT - Driver Initiator Procedure PLABEL. 

DCORP - Driver Conpletor Procedure PLABEL. 

DINTP - Special Interrupt Handler PLRBEl - called 

by GIP if ISPEC is set DFLAG (no other action is 
taken by CIP except to set the Interrupt Status 
in DSTAT). 

DTYPE.DITSIZE - The length of the DIT in uords for this driver. 



I/O 



Lnaical-To-P hy«ical Devic* Table (LPDT) 



| DST « 13 (11 5) 
I SIR * 9 (X11) 

The LPDT has several fields uhich describe the state of a device. Sone of 
these fielde have the sane neaning for all devices. Others *rt device 
dependent, fill are described belou. 

There »rt tuo types of devices represented in the LPDT: real device* and 
virtual devices. A real device is one uhich has been configured into the 
systen and is capable of perforning input and/or output, fl virtual device 
emulates sons of the properties of a real device (for exanple a spooled line 
printer or an INP), but there is no physical I/O involved. The tuo nun uses 
for virtual devicee are for OPEN spooled devicefiles and certain 
communication devices (such as INPs). 

fl given virtual device entry is in use only uhile the devicefile it 
represents is open. Uhen the file is closed by FCLOSE, the entry becones 
available for another virtual device. This is the reason for the 
SYSDURP/INITIflL configurator question RflX N OF OPEN SPOOLFILES— it needs to 
knou hou nany virtual device entries to allocate to the LPDT (and to the 
LOT). 

Entries in the LPDT are ordered by logical device nunber. The first uord 
address of a real device entry is obtained by multiplying the LDN by the 
entry size. Except for the Oth entry, entries for uhich no logical device is 
configured on a given sytten *rt used for virtual device entries. Any 
renaming virtual device entnee follou the last real device entry. 



. r ^iK 
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Entry 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I — I — I — I — • — I — I — I — I — I — I — I — I — I — I — I — 1 

0| KURBER OF ENTRIES IN TRBLE I 

1| ENTRY SIZE" 4 I 

21 DEVREC SERVICE REQUEST COUNT f 

3 i:zzzzzzzzzz:! 

Uord 2 is increnented by a device drivtr whenever it sets the Device 
Ownership State field (belou) to 2 (Service Requested). DEVREC decrttttnts tht 
count for each interrupt it services until tht count reaches 0, at uhich tint 
DEVREC hibernates. 

- CAUTION - 

Device drivers nust lock this table by using 
DISRBLE/ENRBLE, not by trying to acquire 
the LPDT SIR. 



TYPJC»1 S"try MlUfl PWCfs) 



1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 
I — I— I — I — I — I — I — I — I — I — I — I — I — I — I — 1 — ! 
0| 1 | POINTER TO XDD SUBENTRY 
|-| 

11 

I — 
21 

31X01 

l-l 



10 — for input, 1 for output. 

Uord 0, bit is 1 for a virtual device, for a real device. Tht fitldt in 
uord 1 art the sane, as applicable, as for the real device represented by a 
given virtual device. Sec belou. 
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Typical Entry (All Real Devicee) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I — I — I — • — t — I — I — I — I — I — I — I — I — I — I — I — I 

0| 0| I 

I--I--I--I-I-I--I--I 1-|-|-| 1 

|1| | 2| 3| I 51 6| 7 (E0F)| I |12 SUBTYPE I 

| |..|-.|-.|--l--l I-I-I--I 1 

21 SYSDB - RELATIVE POINTER TO THE DIT | 

■: =i 

- Uord 1.( 0:2) - Device Ounership State: 

- Not ouned by any process. 

1 - Ouned by a proceee. 

2 • Service requested - set by driver for 

unexpected interrupt, then uakts DEVREC. 

3 • Device reserved (alternate use) - let 

during :STRRTSPOOL to renove tht device 
fron the pool of available devicee uhile 
other checks are nade or resources art 
acquired; tht fitld is stt to 1 uhen 
these etepe are conpleted. 

2 - Uord 1.( 2:1) - Dtviet it Job/Session Accepting if true. 

3 - Uord 1.( 3:1) • Device is Data Accepting if true. 

5 • Uord 1.( 5:1) - Dtviet is Duplicative if true (all devices 

except discs). 

6 • Uord 1.( 6:1) - Device is Interactive if true (all devices 

except discs). 

7 - Uord 1.( 7:3) - End of File condition: 

- No EOF detected. 

1 - Hardware EOF (e.g., tape nark). 

2 - :DATA record read. 

3 - :E0D record read. 

4 • : HELLO record read. 

5 - :BYE record read. 

6 - :J0B record read. 

7 - :E0J record read. 

12 - Uord 1.(12:4) - Device eubtype - see discussion for tape entry 

(belou) for a description of the Auto bit (12:1). 

The rtnaining bite in Uord 1 art device-dependent and *rt described uith 
their corresponding entry diagram 
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Entry for Teminal-Like Devices 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

|..|H~|~M--IH-MH-M-M-M 
0| 0| 

l--|--|--|--|--|--l--l l~M 

11 I I I 4| | | 10 11 

| 1 - | - 1 - 1 - | -. | 1 - 1 - 1 

2 1 SYSDB - RELATIVE POINTER TO THE OIT I 

| , 1 .. | 1 

I3I I 3| 

, , 1-| 1 

3 - Uord 3.( 3:1) - If set, NUO translation is invoked for ALL data 

transftrrtd to and fron tht device. 

4 - Uord 1.( 4:1) - Centrol-Y is allowed and has been detected. 

10 - Uord 1.(10:1) - BREAK has been detected. I snore BREAK if the CI is 

running. 

11 - Uord 1.(11:1) - The terninal is logging on - this bit is set by PROGEN 

and DEVREC uhen the logon sequence starts. If the bit 
is off uhen polled by INITJSHP the terninal has 
disconnected. Only IOTERHO and HIOTERU HIOTERfl support 
the use of this bit. Rultipoint and DS pseudo-terninals 
do not. 



Entry for Taoe Drives 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 

l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l 
01 01 

I — I — I — I — I — I — I — I l-M-l 

11 I I I 4| | | I I11H2I 

| |..j-|..|..|..| l-l-l-l 

21 SYSOB - RELATIVE POINTER TO THE DIT 

| 1-| 

31 IRRI 
| J.., 



-I 



4 - Uord 1.( 4:1) - BOT. Tape is at Load Point -OR- no tape nounted. 

Recording density nay only be switched uhen this bit is 
true (for nultiple density tape drives). 

11 - Uord 1.(11:1) - If true, DEVREC is perforninq Rutonatic Volune 

Recognition (AVR) on a tape (or PVPROC is doing the sane 
on a serial disc), -OR- AVR is to be suppressed on job 
or data accepting devices. 

12 - Uord 1.(12:1) - Part of Device Subtype field. If true, device nay be 

allocated autonatically uhen opened. If false, operator 

C. 23.00 
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AR - Uord 3.( 2:1) - Bust allocate. AUTO REPLY. Device nay be allocated 
uithout pronpting the operator for REPLY if certain 
run-tine conditions *rt net; this bit is set 
autonatically if uord 1.(12:1) is TRUE. 

Entry for Disc Drives 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

0| 0| 

I-I--I--I "l-l-l-l IH--I 

1| | I I 4| 51 61 110(111 I 

| . 1 - | - | - 1 - 1 - 1 1 - 1 - 1 1 

21 SYSDB - RELATIVE POINTER TO THE DIT | 

l-l-l-l 1 

31 ISDIARI 

l-l-l-l 1 

- Uord 1.( 0:2) - Device Ownership State. flay not be 1 (ouned) for shared 
device (sytten volune or private volune). Serial and 
foreign discs are non-sharablc and nay be owned. See the 
full discussion of this field under Typical Entry, 
above. 

4 - Uord 1.( 4:1) - If true, the disc is a nonsvsten donain (private volune, 

serial disc or foreign disc) disc drive. 

5 - Uord 1.( 5:1) - If true, disc is a nounted private volune. 

6 - Uord 1.( 6:1) - If true, the disc is a reserved volune used to satisfy 

the requirenents of a nultiple volune private volune 
set. 

10 - Uord 1.(10:1) - If true, the disc is a physically and logically nounted 

serial or foreign disc. Bits 5 and 6 nust be false. 

11 - Uord 1.(11:1) - If bit 10 is true, then 1 «»> foreign disc, »«> serial 

disc. 

SD - Uord 3.( 1:1) - If true, the device is currently being used as a serial 
disc (that is, it is allocated to a user as a serial 
disc). This bit duplicates a bit in the LDTK entry so 
that this infornation can be found in a systen 
(nenory- resident) table. 

AR - Uord 3.( 2:1) - AUTO REPLY (serial or foreign disc only) Device nay be 
allocated without pronpting the operator if certain 
run-tine conditions »n net. 
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Logical Device Table (LPT) 



Overview of Data Sequent 



DST 14 (X16) I- 
SIR 10 (Z12) | 



LOGICAL DEVICE 
TABLE 
(LOT) 



LOGICAL DEVICE I 
TABLE EXTENSION | 
(LDTK) | 



-|< OST XI 6 

I 
I 
I 
I 
I 
-I 



-I 



ftro Entry forwat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I — I — t — I — I — I — I — I — I — I — i — I — I — I — I — I — ■ 

HIGHEST ENTRY NUHBER I 



ENTRY SIZE » 7 



STRERHS DEVICE NURBER 



X-s**\ 
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Typical 1-ntry Fpmat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I — I — I — I — I — I — I — I — I — I — I — I — I — ■ — ■ — I — I 

I 0| FILE USE COUNT I 

| 1 

I 1 1 V0LUT1E TABLE INDEX IF DEVICE TYPE « 0-7, | 
I ELSE nAIN PROCESS PIN *, | 

| | OR SPOOLER PROCESS PIN • 

| 2| RECORD UIDTH |CS|FO| DEVICE TYPE I 
I 1 — I — I — I — I — I — I — I — I 1 

| 3 1 SPOOL | SY | DI | ON | TR t HO I CL| SQ 1 DEVICE - DEPENDENT | 
,-,-,-,-l-j-l-,-,-, j 

| 4 |LK | | XDD HEAD INDEX 

| 5| CONTROL-Y PIN I 

, j 

| 61 DEFAULT OUTPUT DEVICE -OR- I 

| DEFAULT CLASS INDEX | 

| 1 

CS - Uord 2.(8:1) - Ccnnunication systen device if set. 
FO - Uord 2.(9:1) - If set, there are special fonts nounted en tht 
device. 
Uord 3.(0:2) - Spooled state of the device: 

- Not spooled. 

1 - Owned by an input spooler. 

2 - Ouned by an output spooler. 

SY - Uord 3.(2:1) - Device is available to systen (not down). 

DI - Uord 3.(3:1) • Device is available to diagnostics (obs). 

DN - Uord 3.(4:1) - :DOUN requested, honored uhen use count ■ 0. 

TR - Uord 3.(5:1) - If set, trailers »rt disabled. 

HD - Uord 3.(6:1) • If set, headers are disabled; these two bits are 

nanaged such that header/trailers are generated in 

pairs or not at all. 
CL - Uord 3.(7:1) • If I/O, uord 6 is the Device Class Table 

index/ LDEVN of the default output class/device 

associated with this device. 
SQ - Uord 3.(8:1) - Spooling has been enabled (spool queues art 

open) for this device. 
Uord 3.(9:1) - Device dependent infornation: 

1. For terninal-like devices, the default 
terninal type to be used if not specified 
in the : HELLO connand. 

2. For variable density tape drives. 
Uord 3.(10:3) - Actual tape density. 
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Uord 3.(13:3) - Dtntity rtquttttd in FOPEN for urittt to 
unlabeled tapat only. 
For tithtr: 

* unknown dontity/no FOPEN u/urite 

1 « 1600 BPI 

2 « 6250 BPI 

3 * 800 BPI 

Mord 4.( 0:1) - Auxiliary lock nechanitn - if ttt, dtviet it 
being deallocated but LOT and XDD art 
inconsistent and their SIRt art rtltattd; 
ALLOCATE cooptrattt by rejecting accttt to 
the dtviet. 



Logical Dtviet Tablt Extantion (LDTX) 
Overvieu of Data Segnent 



| DST 14 (X16) | 

I SIR 10 (212) | 

I LOGICAL DEVICE TABLE 

I (LOT) 

I 

I 

I LOGICAL DEVICE TABLE 
| EXTENSION 

I (LDTX) 



—DST Z16 
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Tt"j"fl En^ry 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
M ..|.. M ~IH~I~I--I--I~I-I--MH" 

0| 0| 0| 0| 0| 0| RESERVED | TBK 

M-l-l-M 1 

11 TERMNAL DESCRIPTOR TABLE OFFSET 
| 

21 CHANNEL 10 
| | 

| 3| NLIO XDS 

| | 

41 
| r 



TBRC > Ttrninal't baud rata codt (CPS ■ eharaettrt ptr ttctmd). 
Speed (CPS) AOCC/ATP (HPIB) TBRC 



Not knoun 





1920 


16 (ATP only) 


960 


8 


480 


9 


240 


7 


120 


11 


60 


6 


30 


13 


15 


14 


14 


— 


10 


15 



IIS « Thia ttrninal it conntcttd to a Uorkttation Configurator port. 

TDT ■ Off ttt f ron tht batt of tht Ttrninal Dttcriptor 
Tablt (TDT) to tht TDT tntry for thit ttrninal. A 
•1 indicattt no TDT tntry tMittt for thit ttrninal. 

NLIO XDS * Extra Data Stgntnt Nunbtr of Uorking ttoragt for 
NLIO translation. 
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?f™ E"tnr 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

0| HIGHEST ENTRY NUhBER 

1 | ENTRY SIZE * 5 
| 

21 



/^Sik 



Tvoical Entry 



Uhtrt: 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|-|-|_|~|H--|~|--|"|"|-M"I~M- ' 



SISDICPIFSIDSI RESERVED I 
•l-l-l-l-l 1 

DEVICE-SPECIFIC INFORHATION FIELDS 



REFER TO THE FOLLOWING EXAHPLES 
(LDTX ENTRIES) 



S • Sttk ahtad tnablt/ditablt flag (aytttn or PV ditc only). 

SD « Thit logical dtviet it a Stnal or Fortign Ditc. 

CP * Thit logical dtviet uttt tht CIPER protocol. 

FS * Thit it a tytttn or PV ditc uith Ditc Frtt Spact nanagtntnt. 

DS * This LDEV it a DS or data connunicationt dtviet. 
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Strial or Foreign Ditc Entry 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

t — i — i — i — I — i — i — i — i — i — i — i — i — i — i — i — ] 

0| 0| 11 01 0| 0| RESERVED I I 

I-I--I-I--I-I 1 1 

1 | SDISC: XDSN FOR VARIABLES, GAP TABLE I 
I FDISC: 1 

21 SDISC: 1 > DATA BUFFER XDS'S ACQUIAEO 
I FDISC: NOT USED 

3 1 SDISC: PCB INDEX UHEN UNITING, ELSE 
I FDISC: NOT USED 
, 

4| 



OT" f^ry 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

l-l-l-l- I -■ — I — I — I — I — I — I — I — I — I — I — 

0| 01 01 11 0| 0| RESERVED |DB| 
I--I-I-I-I-I l-l 

1 | CIPER DEVICE CONTROL OATA SEQUENT « (CDCDS) 

2|DN| CTH INDEX FOR THIS DEVICE (CTM) 
31 



I- 
4! 
I- 



D8 ■ If tit tc 1, thtn debugging it in tfftct. 
ON * If 1. the CIPER facility hat bttn dtaetivattd for thit 
devict because cf error. 
CThl * Control Title Hap Index (an index into tht Control 
Table hap (CTH), uhich is located in tht CDCDS. 



. "^^^v • 
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Systen or Prjvate, Vo^ne Oify Entry 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

|--|~|--|--I~|-I--I--I"I"I--IH-M--M 

0| S| 0| 0| 1 | 0| RESERVED i I 

IH-I-I-I--I 1 1 

11 I 

| 1 

21 DISC FREE SPACE OST NUflBER (OFSOST) I 
| 1 

31 DISC FREE SPACE ERROR STATUS (DFSERR) I 
^_ ____ 

S = Sttk ahead enable/disable flag 
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D-iM Class Table (OCT) 



Overview of Data Segnent 



| DST 40 (Z50) 
| SIR 40 (250) 



DEVICE CLASS TABLE 



(OCT) 



TERHINAL DESCRIPTOR 
TABLE 
(TOT) 






— I DST ISO 
I 
I 

! 

I 

I 
—I 

S 

I 

I 

I 

! 
—I 



Header Entry Forwat 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



-|--|--|--|--|--|--|--M~l--|--!--|--|--|--| 
OCTH» SEGMENT' SIZE I 



DCTH 'ENTRY 'SIZE 
DCTH'NUn'DCV ENTRIES 



DCTH'DCT'BASE (SET TO 6) 
DCTH'hW TOT' ENTRIES 
DCTH' TOT' BASE 



I 
-I 

I 
-I 

I 

1 
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Device Class Table Typical Entry Forwat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
-M-M-M-M-M-M-l-l-l 



CLASS NAF1E (ASCII) 



I 
CYCLICAL POINTER ISO I T I CLASS ACCESS TYPE I 
DCT'NUITOEVICES | 

LDEV 111 | 

LDEV «2 | 



-I 



I n+5| LOEV « n 



1 

I 
1 



The Device Class Table (DCT) contains a varying nunber of variable length 
entries. This is because you nay configure an arbitrary nunber of device 
classes on a systen, and each device class nay be conprised of an arbitrary 
nunber of logical devices. There is one DCT entry per device class, and each 
DCT entry contains a list of logical devices in the class. There is no 
established order of e..tri*c in the DCT, nor is there an order of LDEVe 
uithin an entry. 

Due to the haphazard nature of the DCT, its overall properties are kept in 
the header entry. These include the segnent- relative starting address of the 
DCT (in case the header entry should be expanded later) and the nunber of 
entries in the table. A s'antnt-rtlative pointer to the Teminal Descriptor 
Table (uhic* follows the DCT) nay also oe used to calculate the size of the 
DCT. Also note the "En;ry size" word. It is neaningless for this table, but 
is included for compatibility with other fixed-length entry nFE tables. 

Since the DCT entries are of variable length, uhen you want a particular 
entry you nust always start at the besinnir.g of the DCT and link through each 
entry until you find the one you're interested in. 

Sone fields in the DCT require further description, as foiious: 
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Uord 4.( 1:7) -Cyclical pointer. Currently used only for eysten and private 
volunc disc devices. The pointer varies f ren 1 to N (nunber of 
entries in the class) and indicates the LDEV* in the class 
list on which the last extent was allocated. The disc space 
allocation routines Hill try to satisfy the next request on 
the next disc drive indicated by the cyclical pointer (uith 
wraparound to 1 if the pointer > N). If that fails, the 
pointer is increnented until space ie found or all devices in 
the class have been tried. 

Uord 4.( 8:1) -If set, spooling has been enabled (spool queues opened) for 
this device class. 

Uord 4.( 9:1) -If set, the class it a teminal type class. 

Uord 4.(10:6) -Usually the sane ae the device type represented by the claes 
(0-7 for disc, 24 for tape, 32 for printer, etc.). Serial disc 
classes »rt disc devices accessed as tape drives, so their 
true device types art kept in the LOT, uhiic this field holds 
t tptcial typt (31, or Z37), indicating a atrial I/O 
(non-concurrent) device. Sinilarly, a foreign disc is a 
nonsharable disc drive, to that fact it reflected by a 
tptcial typt 7 in this fitld, tvtn though the true hardware 
type it kept in the LOT, as for serial discs. 
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Terninal Oescriotor Tab le Tvnical Entry Fornat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

,H--|--I--I--I--IH--M--I--I--I--I--I--|--I 
01 

.1 I' 

| DESCRIPTOR FILE NAHE (ASCII) I 

21 12 

■i :• 

3 F 

1 CROUP NAHE I 

61 16 

■: i' 

101 It 

I I 

111 19 

| ACCOUNT HfinE I 

121 no 



I 



KUHBER OF DEVICES IN USING FILE (n) 



LOEVm 



| 16 LDEV N2 



I 

111 
■I 

112 
•I 

113 

I 

114 
•I 



| 

I mX14| LDEV in 



In* 12 
-I 



I- 

Tht Tsrninal Dtscriptor Table contains a varying nunber of variable length 
tntntt, became each Terninal Descriptor entry nay have an arbitrary nunber 
of logical devices. Houever, you can only configure a fixed nunber of valid 
terminal entry filee. These are the TTnn or TTPCLnn files which reside in 
PU8.SYS. SYS is one of these files. 
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Interrupt Unhaoe Table CI LT1 for HP-IB Svstens 



Z0| 
11 
21 
31 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
..,..,.., ..I-I-I-I-I-I-I-I-I-I-I-I-I 
CHANNEL PROGRRH VARIABLE AREA 

(ICPVA) FOR TERHINALS UITH ATP 

DRIVERS, THIS AREA IS ZERO 



IICPVAO (0 for ATP) 

IICPVA01 (0 for ATP) 

IICPVA02 (0 for ATP) 

IICPVA03 (0 for ATP) 

I 

IICPVA04 

I 

IICPVAOS 

1 

IISRQL/ICPGH 

1 1 j 1 

CHRNQUE I I CHAN | DEV IICNTRL 

w , 1 1 1 1 

10ISYSDB RELATIVE POINTER TO CHANNEL PROGRRH AREA IISIOP 



| 

4| DHA ABORT ADDRESS 

I — 
51 

| 

61 
I--I- 

71 m 
I--I 



I- 



11ISYSDB RELATIVE POINTER TO STATUS RETURN AREA 

12 1 SINGLE INSTRUCTION THAT IS EXECUTEO TO EXTRRCT 
| THE DEVICE UNIT NUtlBER FROfl THE STATUS POINTED 
| TO BY ISTAP 



-I 
I ISTAP 



13ISYSDB RELATIVE DIT POINTER OF THE DEVICE 
CURRENTLY USING THE CHRNNEL TO PERFORn A DATA 
| OPERATION 



I- 
14| SIOPSIZE 

l-l-l-l-l-l- 
15|RU|UP|IG|SC|SQI 

I-I--I-I--I-I- 



-I- 



CQUEN 
1- 



| HCUNIT 
-I- 



161 SYSD8 RELATIVE DIT POINTER FOR UNIT 
| 



-I 

IIUNIT 
I 
I 
I 

IICDP 
I 
I 
I 

IIQUEUE 
I 

I IF LAG 
I 

IIDITPO 
I 



-I 



I SYSDB RELATIVE DIT POINTER FOR UNIT n IIDITPN 



PROGRRH STATUS RETURN AREA 
POINTED TO BY ISTAP 



| SEEKHASK (DISC ONLY) 



I/O 



I/O 



W (Wt) 



IPCVA - These four words conprise the channel progran 

variable area where infornatien is stored concerning 
a channel progran Interrupt instruction or abort. 
CPVRO should be used only for channel progran aborts. 
ICPVA4 - Uords 4 and 5 contain DHA address, when channel progran 

aborts during DHA transfer. 
ISRQL - Serial poll request queue length. HP-IB System do 
not support any serial poll devices. This should 
aluays be zero. 
ICPGfl - This is the SYSDB relative address of the channel progran 
to be started for this device after receiving a HIOP 
interrupt in GIP. GIP uill call SI ART 10 uhen the flags 
word indicates "ignore halt interrupt" and "start channel 
progran" bits are set. 
ICNTRL - Contains controller infomation. 

,fl - If set, the controller is sharing a softuare 
channel resource in order to Unit banduidth. 
.CKNQ - The software channel resource nunber. 
.DRTN - The DRT nunber for a Series 33 device it 
equivalent to: 
.CHAN - channel nunber (4 nost significant bits 

of DRTN) 
.DEV - device nunber (3 least significant bits 
of DRTN) 
IFLRG - Used for controller flags. 

.RU - Runuait flag. An idle channel progran should 
be started uhen there are no active requests 
to process. 
.UP - Uaitprog flag. An idle channel progran has been 
started for this controller. This bit is reset 
by an interrupt. 
.IG - Ignorehi flag. An HIOP instruction has been 

issued against t*;§ controller, but the channel 
progr4n uas net in a uait statenent. Therefore, 
ignore the interrupt generated by the channel 
code uhen this progran hilts. 
.SC - Start channel progran fJag. Uhtn set along 
uith the IG fJag, GIP uill start a previously 
attenpted SI3P en this device. 
.SQ - Start channel prograr "queued" flag, iihen bit 
SC is set, this bit *:il detemine if the eall 
to START' HPIB uill h*vt logical paraneter 
QUEUEO true or false. 
.HCUNIT - Highest configured unit nunter for this 
controller. 
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Device Infomation Table (DIT) 



There is one DIT per physical device. If a physical dtviee represents 
represents none than one logical device, the logical device nunber is 
obtained frcn the I/O queue elenent. Although details of DITs wy uith 
device, the following structure is cotmon to all: 



MT for HP-IB Svstene 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

-l-l-l-l-l-hhl-l-l-l-l-l-l-l-l „ 
T| DlRCIRQISIIItUl OIIOIIRINOISTINSI STATE DFLflG 
-|--l--l--|--l"l~l--l--l--l~l--l--l--l"l 

SYSDB RELATIVE POINTER TO THE DIT FOR DUNK 

THE NEXT DEVICE REQUESTING 

THIS RESOURCE OR SERVICE 



SYSDB RELATIVE POINTER TO THE FIRST 
IOQ IN REQUEST LIST 
FOR THIS DEVICE 



DIOQP 



LOGICAL DEVICE KUHBER 



SYSDB RELATIVE POINTER TO DEVICE 
LINKAGE TABLE 



SYSDB RELATIVE POINTER TO INTERRUPT 
LINKAGE TABLE 



CONTROLLER HAROUARE STATUS 



HARDURRE ERROR STATUS. SET UHEN THE 
DRIVER DETECTS RN ERROR. UHENEVER 
<>0, THE DRIVER HONITCR LOGS RN 
RN I/O ERROR AND CLEARS THIS UORD 



I 10 

I 12 IOT | 
| 1- 



DEVICE DEPENDENT AREA 



DEVICE DEPENDENT AREA 



-I- 
I PHYSICAL UNIT II 



-!-. 



DLDEV 
DDLTP 



DILTP 



DSTAT 
DSERR 



DTIHE 
DTRQX 



DUNIT 



DTRQX Used by tone device drivers, it denotes tiner 
request ineew. 
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PIT Tenunoloqy for HP-IB Svstens 



DFLAG - Oevice relative flags. 

T - Set if device is a terminal. 

- Stt if device is a disc. 

AC - Active bit; 1 mplies a nonitor currently servicing 

this device. 
RQ - Request bit; 1 inplies service requested uhile the 

nonitor is active, 
nu - If set, indicates device is a nultiple unit 

controller. 
10 - If set, a channel progran is currently executing. 
Ifi - If set, an interrupt or response has occurrtd. 
NO - If set, device is in a not ready or operator uait 

state. 
ST - If set, an idle channel progran should be started 

for this device. 
SI - Special interrupt handler. 
NS - Oo not short uait this disc. 
STRTE - Current driver state as defined by the nonitor. 
Rllouable states trt: 
ZO - Start request 

1 - Not used (reserved) 

2 - Call driver initiator 

3 - Call driver conpletor 

4 - Not used (reserved) 

5 - Conplete request 

6 - Unexpected interrupt occurrtd 

7 - Start operator intervention uait 

10 - Operator uait; restart at 

11 - Data nakep resent/freeze uait 

12 - Initiator code nakep re sent /freeze uait 

13 - Interrupt conpletion uait 

14 - Oevice controller availability uait 

15 - Not used (reserved) 

16 - Initiator code nakepresent uait 

17 - Conpletor code nakepresent uait 
DUNIT - I/O systen type and unit nunber. 

IOT - I/O Systen type: 

- Series II/III I/O Systen 

1 - HP-IB Systens 

2 - Unused 

3 - Unused 
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Oevice Information Table fDIT) for CIPER 

There is one PIT per physical device. If a physical device represents nore 
than one logical device, the logical device nunber is obtained fron the 100 
elenent (however, this driver only supports one device per controller.) The 
following diagran shous the OIT used for the HP-IB CIPER physical driver. 

1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 MNEMONIC 
, ,-.|.-,„,-|~|~|-|--|--|"|"|~|«|--|"|"| 

ZO| 0| OIRCIRQI 0| 0| O|I0|IR|N0|ST| 0| STRTE IDFLAG 
, HHH -. M -,~|~|~|--I--I~I 1 

SYSDB RELATIVE POINTER TO THE OIT |DUNK 
FOR THE NEXT OEVICE REQUESTING | 
THIS RESOURCE OR SERVICE I 



IOQ TABLE INDEX TO THE FIRST IOQ IDIOQP 
IN THE REQUEST LIST FOR | 

j THIS DEVICE I 

, 1 1 

3 1 PHYSICAL UNIT N | LOGICAL DEVICE NUMBER IDLDEV 
, 1 1 

4 | SYSDB RELATIVE POINTER TO I0DLTP 

I DEVICE LINKAGE TABLE 



5| 



SYSDB RELATIVE POINTER TO 
INTERRUPT LINKAGE TABLE 
j - 1 - 1 - 1 - 1 - 1 1 

6|VS|RBiRE|TP|NR| NR CNT | DEVICE STATUS 
|.-|.-|-.|-|-| 1 

HARDUARE ERROR STATUS - SET UHEN THE 
DRIVER DETECTS AN ERROR; 
IF <> 0, THE DRIVER 
MONITOR LOGS AN I/O ERROR RND 
CLEARS THIS UORD 



7| 
I 

I 

s 
I 
I- 

101 

i- 
iii 



! 
-I 

IDILTP 

I 
-I 

IDSRVE 
-I 

IDSERR 



BIT IS SET AT COMPLETION OF TIMER 



IDTIME 
-I 



HOLDS THE TIME OUT REQUEST ENTRY INOEX IDRQST 
! UHILE A TIMER IS ACTIVE I 

| 1 1 1 

121 IOT | I PHYSICAL UNIT NUMBER I DUNIT 
I--I-M-I 1 l-l 1 ! 

13|RFjUE|DE|TD|UNIT CNTIDATA CNT| TO CNT |PRTY CNT|DCOUNTS 

14| ERROR LOGGING LOCATION 11 IDLQGERROR 

151 ERROR LOGGING LOCATION «2 I0LOGC0UNT 
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IA 



IOPROG 
IRK 

NOTRDY 
ST STUAIT 



STATE 



DFLBG - Flags and request state. 
AC ACTIVE - A nonitor is currently ttrvicing this dtviet. 
RQ REQUEST - A service request is pending uhilt tht nonitor is 
active. 

- An I/O Channel Progran is running for this dtviet. 

- An interrupt or response has occurrtd for this dtviet. 

- Go to statt Z10 afttr Idle Channel Progran is started. 

- The device nonitor is starting an Idle Channel Progran 
for this device; there is no IOQ associattd uith this 
type of request. 

- State of the device nonitor; specifies tht ntxt action 
to be taken in SIODH in servicing tht request: 

ZO - Start neu request 

1 - Not used 

2 - Call driver initiator procedure 

3 - Call driver conpletor procedure 

4 - Not used 

5 - Process request conpleted 

6 - Initiate device recognition stqutnet 

7 - Start operator intervention uait 

10 - Uait for interrupt (operator intervention) 

restart at state 

11 - Uait for data segnent freeze, then statt Z 

12 - Uait for driver initiator to bt frozen, then 

allocate controller (statt 2) 

13 - Uait for I/O conplttion interrupt, thtn statt 3 

14 - Uait for controlltr, thtn call driver initiator 

15 - Not used 

16 - Uait for initiator nake prtstnt, then statt 2 

17 - Uait for conpletor nake present, thtn statt 3 

OLDEV - Logical device nunber. 

DUNIT - I/O systen type and unit nunbtr. 

- HP 3000 Series II/III 

1 - HP 3000 HP-IB 

2 - Unused 

3 - Unused 



^m\ 
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DSAVE - Device processing flags. 

VS • VALID STATUS - Set to indicate Dtviet Status has been updated. 
RB - DVRABFLAG - Sequence Abort in progress dut to ABORT request. 
RE - RETRYFLAG - Stquence Abort in progress due to an error. 
TP - TIMERPOPPED - Current error is due to software tintr popping. 
NR - NOTRDYFLAG - Not Ready Uait in progress. 

NR CNT - Nunber of Not Ready Uaits during this request. 
DEVICE STATUS - Device status returned during a Sequence Abort. 
BIT 8 - CRC available and enabled. 

9 - Reserved. 
" 10 - Reeervtd. 
" 11 - Reserved. 

" 12 - Power fail or rtstt has occurrtd. 
" 13 - A protocol trror has been detected. 
" 14 - A parity error has been detected. 
" 15 - The peripheral has data to send. 

DSERR - Pointer to status to bt logged. 

Bits (0:8) - Nunber of uords to be logged. 
Bits (8:8) - Offset rtlativt to DITP(O). 

DCQUNTS - trror flags and error counts (4). 

RF - REQ FAILED - fln error has forced this rtqutst to be aborted. 

UE - UNIT ERROR - The current error is a Unit Error. 

DE - DATA ERROR - The current error is a Data Error. 

TO - TIME OUT - The current error is a GIC Tine Out Error. 

UNIT CNT - Nunber of Unit Errors during this request. 

DATA CNT - Nunber of Data Errors during this request. 

TO CNT - Nunber of GIC Tine Outs during this request. 

PRTY CNT • Nunber of HP- IB Parity Errors during this request. 
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PIT for Channel Oevictt 



1 



2 3 4 5 6 7 8 9 10 11 12 13 14 15 

, | |— |— |— I 1 1 1— I l-l-l-l-l-l- 

TERfl DISC|RCT|REQI I H | SXO I 10 |IRK| fl |HT| | STATE 
IUNITI PREflP|PROG| |HERD|RY| I 



I- 



., 1 — I — I — I 1- 



1 | NEXT OITP 
| 

21 IOQP 
I- 



-I 1 — I l~M- 



31 



LOGICRL DEVICE NUHBER 



OLTP 



ILTP 



61 



CONTROLLER HRROURRE STATUS 



I 101 
I- 



7| HRROURRE ERROR STATUS 
| 



111 
| 1~ 

121 IOT 12 
I 



PHYSICAL UNIT « 



DRIVER DEPENDENT DIT AREA 



I 

OFLRG.TERMNRL - Dtvict it a ttrninal. 



DFLAG 

DUNK 
DIOQP 
DLDEV 
DDLTP 
DILTP 
DSTAT 
DSERR 
DTME 
DTRQX 
DUNIT 



I /O 



DIT for Channel Devic *« (Cont.) 



DFLAG. STATE - 



This quantity specifies the next action to be taken 
in servicing the request. 



.DISC 

.ACTIVE 

.REQUEST 

.RUNIT 

.SIOPREflPT 

.IOPROG 

.IRK 
.n HEAD 
.NT RY 



Device is a disc (Bit « 0). 

- A nonitor is currently servicing this dtvict. 

- Strvice requested uhile nonitor uas active. 

- Dtvict controlltr strvicing nultiplt unttt. 

- If stt thtn a request has been queued for 
this device; prtenpt code is stt in 100. 

- I/O progran in progress; dtcrentnt SIOCOUNT and 
check for nulti-channel uhtn conplttt. 

- Inttrrupt or Response has occurred. 

- Roving head disc. 

- Not ready for SIO; SIOOH holds off ntxt SIO until 
RLLOUPOLL is done. 
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ZO - Neu; start request 

1 - Not used 

2 - Call Driver Initiator Procedure 

3 - Call Driver Conpletor Procedure 

5 - Conplete request 

6 - Device recognition 

7 - Start operator intervention uait (Z10> 

10 - Restart request on interrupt 

11 - Uait for data to be frozen then state 2 

12 - Uait for driver code to be frozen then state 2 

13 - Call conpletor on interrupt 

14 - Uait for device controller 

15 - Not used 

16 - Uait for initiator nake present then state 2 

17 - Uait for conpletor nake present then state 3 

OLINK - SYSDB relative pointer to the DIT for the next device 

requesting this resource or service. 
DIOQP - SYSDB relative pointer to the first IOQ in the request 

list for this device. 
DLDEV - Logical Device Nunber. 
DDLTP - SYSDB rtlativt pointtr to tht DLT. 
DILTP - SYSDB rtlativt pointtr to tht ILT. 
DSTAT - inttrrupt status for this dtvict. 

dtvict inttrrupts. 
DSERR - Hardware Dtvict Controlltr Statut. Stt uhtn tht driver 

dtttctt an trror. Uhtntvtr not ztro, SIODB logs an 

I/O trror and cltars this uord. 
DTME - Tmtout conpltttd flags. If a tintout occurs in response 

to a tiner request type Z20 (I/O request), the sign bit 

is set in this uord. The IA bit in DFLAG is also set, 

and tht nonitor for this dtvict is awakened. (Only used 

if tintr services art rtqutsttd. nust bt uord N8 if tiner 

strvicts art rtqutsttd.) 
OTROX - Ustd by sont dtvict dnvtrs, it dtnotts tintr rtqutst index. 
DUNIT - I/O systen type and unit nunber. 
.UNIT - Unit nunber of the physical device. 
.IOT - 10 type 0* Seriet III I/O; 1» HPIB I/O 



/tmmK 



Stt tach tint tht 



I/O 



PIT Far 79OS/7906/7920/7925 



12 3 4 5 

l-i-l— I— !-~ ! 



6 7 



8 9 10 11 12 13 14 15 
•l-l-l-l-l-l-l-l 



1 
2 
3 
4 
5 
6 
7 
I 10 
I 11 



|0 DFLAG 



0| 1|RCT|REQI COI U | 0| I/OIIRKl 1| 0| 0| STATE 
I I I I IUNITI IPROGj I I J I 

.., H ..-,- H — | 1~| 1 — 1—|— |— | 

NEXT DITP „__ _. 

WRRENUACTIVE) DISC REQUEST ^ ,_, jmr ,„„ J 2 ° IWP 

_—.—_——-——— ^ ^^ 

,. . ,™_- ^ ^^ 
™™- ^ ^^ 



LOGICRL DEVICE NUTOER 



OLTP 



ILTP 



-1 UHEN POUER FRIL 



« OF ERROR UORDS TO LOG 



INDEX OF FIRST REQUEST IN QUEUE 



DIT REL ADDR TO LOG 7 DSERR 

8 onflM 

9 DfUMQT 



INOEX OF LAST REQUEST IN QUEUE ^ 

| 121 IOT | I PHYSICAL UNIT • 

| — ..j. ..——————— j 

I 131 



SIO PROGRAft-RELATIVE ABORT ADDRESS 



I- 

| 14| CURRENT PHYSICAL 
I I — 
| 151 DISK RDDRESS 

| 161 CURRENT DATA BUFFER ADDRESS 

| 17| UORD COUNT REP-AIRING 

| 20 | CURRENT UORD COUNT 

I 

| 21 | SYSBUF INDEX 

| 

| 22| STATUS 1 RETURN 
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PIT For 7905/7906/7920/7925 (Cont.) 



I »i 
I- 



HERO 



SECTOR 



PATT2 



PATT 3 



I- 
I 23 1 

I- 
I 24| 

I- 
I 25I 

I- 
I 26| 

I- 
I 27| 



STATUS 2 RETURN 
CYL 



HERO 



SECTOR 



STATUS 1 RETURN 
CYL 



10 DUNIT 

11 DLOGSIOP 
12CPDA 

13 

14 CD8A 

15 UCR 

16 CUC 

17 SYSBUFR 

18 STAT1 

19 STAT2 
20CEW 

21 

\ 
22 1 

I 
23I 
I I 



| 31j DISPLACEhtNT 
| 321 PATT 1 



I 33 
I 34 
I 35 

I 36 
I 37 
140 



141 
I 
I 42 

143 

I 44 

1451 



SECTOR COUNT TO TRANSFER 



INITIALIZE RDDRESS 



-I- 



I 
241 

> REQUEST 
251 SYNDROflf 

I 
261 

I 
1271 

I 
281 

/ 

29 SCOUNT 

30 INITRDR 
31 



CONTROLLER STATUS RFTER SEEK 
IN CHANNEL PRQGRRfl 



—|- 



| L 32 DHISC 



... 



CPVR UORO UPON CHANNEL ABORT 



CURRENT LOGICAL SECTOR RDDRESS 



CURRENT LOGICAL SECTOR RDDRESS 



| 33 SEEKSTAT 
34 

35 DL0GERR08 

36 CLDfl 
37 
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(15:1) L'STRT'ERt - 1 last transftr tndtd in trror. 

DUNIT - I/O systen type and unit nunbtr. 
IOT - I/O Dtvictt. 

- Non-HP-IB 

1 - HP-IB Systtns 

2 - Unused 

3 • Unustd 



/W^. 
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I/O 



Error and Retry Information 

12 3 4 5 6 7 8 •W 11 ""^, 

i"Di"si"Ei"n!"u!"T!"oi"cicu"o l "o "o "oi"retry""iqmsc OF 100 

l-l-l-l-l-l-l-l-l-l 1 1 

- Retry determination 
S - Request syndrone 
E - Request error information 
n - Update track nap 
U - Writing track nap 
C - Issued a recalibration 
CL - Oriver issuing channel clear 
T - Tweout uaxt 

NOTE: Integrated Cartridge Tape's OIT has the sane format. 

CS 80 Disc Dtviee Inform ation Table (PIT) 

There is one OIT per physical device. If a physical device represents nore 
than one logical device, the logical device nunber is obtained fron the IOQ 
elenent. For the CS»80 disc controller, there Mill only be one device. The 
foiloumg diagran shous the OIT used by the CS'80 disc driver. 

1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 NNEflONIC 
| — | — | — | — | — I — I — I — I — I — I — l — I — I — I — I — I 

ZOlTnlDSIRCIRQICDI 0| O|I0|IR|N0|ST| 0| STATE IDFLAG 

1 ""sYSDB~RELATIVE POINTER TO THE OIT OUNK 
FOR THE NEXT DEVICE REQUESTING 
THIS RESOURCE OR SERVICE 



I /0 



CS 80 Disc p»viei Inform ation Table fOITl (Cont.) 



DSTAT IS -1 UHEN A SYSTEfl POUERFRIL 
OCCURRED 



I 
I 
I 

101 
I 

111 



HRRDURRE ERROR STRTUS. SET UHEN THE 
DRIVER DETECTS RN ERROR. 
WHENEVER <> 0, THE ORIVER HONITOR 
LOGS RN I/O ERROR AND CLEARS 
THIS UORD. 

INDEX OF FIRST REQUEST IN QUEUE 



-I 
I OSTflT 

I 
-I 
IDSERR 

I 



IDQHERD ' 
-I 

IDQTRIL i 
-I 

I DUN IT 
-I 



INDEX OF LAST REQUEST IN QUEUE 
| | 1 

121 IOT | PHYSICAL UNIT « 

13ITR8LERELATIVE INDEX TO SYSTEH BUFFER ELEHENT j 
I I 

14 | HIGH ORDER LOGICAL SECTOR ADDRESS OF BAD BL0CKIDBADBLK1 
I 1 

151 LOU ORDER LOGICAL SECTOR RDDRESS OF BRD BLOCK IDBA0BLK2 



21 



CURRENT REQUEST INDEX 


LOGICAL DEVICE NUNBER 


SYSDB RELATIVE POINTER TO DEVICE 
LINKAGE TABLE 


SYSDB RELATIVE POINTER TO INTERRUPT 
LINKAGE TABLE 



OCURREQP 

DLDEV 

DDLTP 

OILTP 



161 BYTE TRANSFER LEFT UHEM BRD BLOCK OCCURRED 
17 | "hardware LOGGED ERROR STATUS - CPVA (0) 

20 1 CHANNEL PROGRRII ABORTED RELATIVE OFFSET 

I 



I 

IDBADXFER 
-I 

I0LOGERR0R 
-I 

IDSIOPSTOP 
-I 



G. 23.00 
13- 31 



r 



211 DISC STATUS (20 BYTESJ-LOGGED ON STATUS ERROR IDSTATUS 
, -| 

i : 

1 i .. i - 1 - 1 1 1 

33|LK|IF|nD| I SUBSTATE IDfllSC 

| ., I .. | - 1 -- 1 1 1 

34 1 RE | DC I OR | EN | I LOCAL STATE I RPSU0R01 

| | .. | .- 1 .. | - 1 1 1 1 

35| T1 I T2 IRSPU0RD2 

, 1 1 

DFLAG - Flags and request state. 

TH TERI1 - Set if device is a terminal. 

DS DISC - If TH = and this bit is set then the dcvict it 

a disc, otherwise device dependent. 
AC ACTIVE - A monitor is currently servicing this device. 
RQ REQUEST - A service request is pending while the nonitor it 

active. 
10 IOPROG - Rn I/O Channel Program it running for thit device. 
IA IAK - An interrupt or retponse has occurred for thit device. 
NO NOTRDY - Go to the state Z10 after Idle Channel Program is stated. 

G. 23.00 
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I/O 



r 



ST STUAIT - The device nonitor it starting an Idle Channel Program 
for thit device; there it no IOQ associated uith thit 
type of requett. 

STATE - State of the device monitor; specifies the next action 
to be taken in SI00I1 in servicing the requett: 

XO - Start neu request 

1 - Not uted 

2 - Call driver initiator procedure 

3 - Call driver conplitor procedure 

4 - Not uted 

5 - Process request completed 

6 - Initiate device recognition sequence 

7 - Start operator intervention uait 

10 - Wait for interrupt (operator intervention) 

rettart at ttate 

11 - Uait for data tegment freeze, then state 2 

12 - Uait for driver initiator to be frozen, then 

allocate controller (state 2) 

13 - Uait for I/O conpletion interrupt, then state 3 

14 - Uait for controller, then call driver initiator 

15 - Not uted 

16 - Uait for initiator make present, then ttate 2 

17 - Uait for conpletor make present, then state 3 

DUNK - A SYSDB relative pointer to the neat OIT requetting thit 
resource or service. 

OCURREQP - A current requett tysbate index. 

DUNN. (0:2) - I/O system type and unit number. 

- Non-HP-IB 

1 - HP 3000 HP-IB Systcne 

2 • Unused 

3 • Unused 

DLDEV • Logical device number of thit device. 

DSTAT - Set to a -1 when a tytten peuerfail hat occurred. 

DSERR - Pointer to ttatut to bt logged: 

Bits (0:7) - Number of wordt to be lowed. 
Bitt(8:15) - Of feet relative to DITP(O). 

OHISC - Device dependent processing flags. 

LOCK* FIG • Lock flag denoting unload status of the disc volume: 

- Allow operator unload to the volume. 

1 - Oeny operator unload to the volume . 

IGNORE* INT' FLG- Ignore unexpected interrupt flag. 

6.23.00 
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SUBSTRTE - Indicates state of the idle channel program: 

- Normal idle channel progran wait. 

1 • Idle request being serviced wait. 

DS8UFA00R • SYSOB relative pointer to the tytten buffer elenent 
used to read the DSCT; sera, if no elenent gotten. 

DBAD8LK1 - High order logical sector address of the bad block 
for the Defective Sector Table (DSCT) entry. 

D8ADBLK2 - Lou order logical sector address of the bad block for 
the DSCT entry. 

OBADXFER - Byte transfer left when bad block occurred. 

DLOGERROR - CPVA(O) logged en hardware error ttatut. 

DSIOPSTOP - Stopped channel proaran relative offeet location due 
to an error in CPVR(0). 

DSTATUS - 20 bytet ditc ttatut logged on status error 
(See CS'80 Disc Drive Statue). 

RPSU0RD1 - Flags and local state: 

RE - Read revision code done. 

Set if read revision code level ie done. 
DC - RPS revision code. 

Set if controller is "PEP"ed. 
OR - RPS desirable. 

Set if RPS is deeirable. 
EN - RPS enabled. 

Set if default value for RPS is enabled. 
IfR • Oriver is processing a narginal data error 

from the drive; does not return hard error. 
Local State • State of the local request made by driver: 

- No local request is being processed. 

1 - Reading revision code. 

2 - Setting default RPS. 

RPSU0RD2 - Default value for RPS. 

T1 - Tine to target in hundreds of nicroseeonde. 
T2 - Uindou size in hundreds of nicroseconds. 
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PIT for 7970 Aaqnttic Tm 



12 3 4 5 6 7 8 9 10 11 12 13 14 15 

|..|..|.-.|~ l-l l-l — |— 1--|--|--|--|--|--| 

I 0| 0|ACT|REQ| 0| R | Ol I/OIIWCl 0| 0| 0| STATE 
III IUMITI |PAOG| I I I I 

1 | NEXT OITP 



ICQP 

LOGICAL DEVICE NUABER 



OLT PTR 



51 ILT PTR 

l-l-l— I— l-l- 
6IRHIRUI SH| CEIDCI 

l-l-l— I — l-l- 
7| ERROR STATUS 

| 

TIHEOUT FLAGS 



HARDURRE STATUS 



I 
IOFLAG 

I 
1 

I DUNK 
1 

IOIOQP 
1 

IOLDEV 



IOOLTP 

-I 

IOILTP 
-I 

IOSTAT 



— I 



I 101 

, 

| 111 TWER REQUEST INDEX 

I 121 IOT | 
| | 1~ 

I 131 

| | 

DUNIT - I/O systtn typt and unit nunbtr. 
IOT - I/O Dtvices. 

- Non-HP-IB 

1 - HP-IB Systtnt 

3 - Unustd 

4 - Unuttd 



IDSERR 
-I 

IDTIRE 
-I 



IDTRQX 

PHYSICAL UHIT • | DUNIT 
-l-l-l 

|R4|RU|DDFLAGS 
-l-l-l 



DSAVE - Devict 
RU RUBIT - 
RU RUUNLD - 



procitting flags. 
Indicates tape has bttn rewound. 
Indicates that a rtumd/unload uat ptrfomtd to allou a 
uritt-ring nount. 
SH SHORT - A short road it in progrttt; afttr conpletion of rtad, 
EOF it chtcktd for and if not prtttnt, tht nquttttd 
bytes art trantftrrtd fron tht thort-rtad bufftr to tht 
uttr't bufftr. 

Channtl parity trror processing it in progrttt. 
Trantftr uttd data chaining - ustd for conputing tht 
trantnittion log. 
Dtvict dtptndtnt flags. 

(bit 14) if ttt, nttd to reuind tapt btfort ntxt uritt. 
(bit 15) if ttt, taps is mound. 
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CE CESTAT - 
DC DSFLAG - 

DDFLAGS • 

I R4 DDFLAGS - 

RU DDFLAGS - 



I/O 



finiSC 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
..,..| H ..,--|--|--|"|-|-|-I-I"!-|-|-! 

| | | | | | IFORURRD I BACK | I 

R| 8| F| G| E| SI Ul SPACE I SPACE I RETRY | 

| | | | I I I COUNTER I COUNTER (COUNTER I 
..|..|..|~|..|~|--l 1 1 1 



Retry in progress. 
Backspace in progress. 

Forward space in progress. 

Gap in progress. 

Backspace on data end-of-file. 

Short read in progress. 

Unload tape for unte ring installation. 
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PIT for 7974/78 h>«nttjc Tapt privet 



Thtrt it ont DIT ptr physical dtvict. If a physical dtvict rtprtstnts nort 
than ont logical dtvict, tht logical dtvict nunbtr is obtained fron tht IOQ 
tltntnt. Tht follouing diagran shout tht DIT uttd for tht nag tapt drivtr. 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

0| 0| OIRCIRQI OIIWI OIIOIIAIKOISTI 0| STATE | 



,.+..«.< 



•-♦— 4— ♦— ♦-< 



1| SYSDB rtlativt pointer to tht DIT for tht next I 
I dtvict rtquetting thit rttourct or service | 

21 SYSOB rtlativt pointtr to tht first IOQ in | 
I rtquttt litt for thit dtvict I 

3| Logical devict nunbtr I 

4| SYSDB rtlativt pointtr to Dtvict Linkagt Tahiti 

5| SYSDB rtlativt pntr to Inttrrupt Linkagt Tahiti 

♦—♦—♦— ♦—♦—4— ♦-————— ————♦--♦ 

6|RU|RU|SH| |PF| |EOV| |PA| 

7| Harduart trror status. Stt uhtn tht drivtr I 
I dtttcts an trror. Uhtntvtr <>0, tht drivtr j 
I nonitor logs an I/O trror and clears thit uordj 



Z10| Bit it ttt at eonplttion of tintr 



I 



Z11 | Interrupt status for this unit. Stt by tht I 
I drivtr tach tint it proctssts an inttrrupt. I 



Z12I IOT I///////////I Physical unit 



I 



Z13| Holds tht tint out rtquttt entry index uhila I 
I a tintr it active. I 

Z14| Error log. Contains 5 valid bytts of otatus I 



nNERONIC 
DFLAG 
DUhK 

OIOQP 

DLDEV 
DOLTP 
DILTP 
DSAVE 
DSERA 

OTW£ 
DSTRT 

DUNIT 
DRQST 

DLOGCRROR 



DFLAG 


- Flags 
ACTIVE 


AC 


RQ 


REQUEST 


nu 


IHJNIT 


10 


IOPROG 


IA 


IRK 


NO 


NOTRDY 


ST 


STUAIT 
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STATE 



and request state 

- A nonitor is currently servicing this devict. 

- A service request is pending uhile the nonitor it 
active. 

- This device is on a milt: -unit controller. 

- An I/O Channel Progran is running for this devict. 

- An inte-rupt or response has occurred for this devict. 

- Go to state HO after Idle Channel Progran is started. 

- The devict nonitcr it starting an Idle Channel Progran 
for this device. There ts no IOQ associated uith this 
type of request. 

- Statt of the devict nonitor. Specifies tht next action 
to be taken in SIODfl in servicing the request: 

- start neu request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver conpletor procedure 

4 - not ustd 

5 - process request conpleted 

6 - initiate device recognition sequence 

7 - start operator intervention uait 

Z10 - uait for interrupt (operator intervention) 

restart at state 
Z11 - uait for data segnent freczt, thtn statt 2 
Z12 - uait for drivtr initiator to bt frozen, thtn 

allocate controller (state 2) 
Z13 - uait for I/O conpletion interrupt, thtn statt 3 
Z14 - uait for controller, then call drivtr initiator 
Z15 - not ustd 

116 - uait for initiator nake present, then state 2 
Z17 - uait for conpletor n*kt present, then state 3 



I DSAVE - Device processing flags 



RUBIT • 
RUUNLD • 



SH SHORT 



| PF PQUER 



Indicates tapt has been rewc-nd. 

Indicates that a reuind/unkad uas ptrfomtd to allou a 

urite-ring nount. 

A short rea«* is in progrest. After conpletion of read, 

EOF is checked for and if not pi»sent, the requested 

bytes are transfered fron the short-read buffer to the 

user's buffer. 

Device pouer up indication. 

| PA PENDING ABORT - Rn abort is pending for a ronnand queued IOQ. 
I FO FIRST OPERRTION - The first read or unte after a reuind 
| rconnand is not done in queuirg nooe. 

I EOV End'Of'Volunc - enable check on 2 con»*«.jtive EOFs. 



G.23.00 
13- 38 



I/O 



IOSTAT ■ 

BITS 



1 
2 
3 

4 
5 

6 

7 
8 

9 

10 
11 
12 

13 
14 
15 



Hag tape controller statue 

USE 

END OF FILE (EOF) 

BEGINNING OF TAPE (BOT) / LORD POINT (LP) 

END OF TAPE (EOT) 

SINGLE TRACK ERROR (NOT LOGGED FOR RERDS) 

COfMAND REJECT (REJECT) 

FILE PROTECT (NOT URITE ENABLED; NO URITE RING) 

HULTIPLE TRACK ERROR (HTE) 

UNIT ONLINE 

GCR (6250 BPI DENSITY) 

UNIT NUHBER (RSB) 

UNIT NURBER (LSB) 
TIRING ERROR 
TAPE RUNRUAY 



REUINDING 
UNIT BUSY 
INTERFACE BUSY 



** (REPORTED RS UNIT NOT READY) 



I/O 



PIT for 7979/80 Hagnetic & DAT Tape Drives 

There is one OIT per physical device. If a physical device represents ncre 
than one logical device, the logical device nunber is obtained fron the IOQ 
array. 
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DFLAG - Device Flags and Request State. 

AC - R nonitor is currently servicing this device. 
RQ - R service request is pending uhile the nonitor is 

active. 
flU - This device is on a nulti-unit controller. 
10 - An I/O Channel Progran is running for this device. 
IA - An interrupt or response has occurred for this 

device. 
NO - Not ready, start Idle Channel Progran then go to 

state Z10. 
ST - The device nonitor is starting *n idle channel 

progran for this device. There is no IOQ 

associated uith this state. 

STATE - Device floritor State. 

Specifies the next action to be taken by SlGDfl in 
servicing the request: 

- Start a neu request. 

1 - Not used. 

2 - Call driver initiator procedure. 

3 - Call driver conpletor procedure. 

4 - Not used. 

5 - Conpleted request processing. 

6 - Initiate device recognition sequence. 

7 - Start operator intervention uait. 

Z10 - Uait for interrupt (operator intervention), 

restart at state 0. 
Z11 - Uait for data segment freeze, then state 2. 
Z12 - Uait for driver initiator to be frozen, then 

allocate controller (state 2). 
Z13 - Uait for I/O conpletion interrupt, then state 3. 
Z14 - Uait for controller, then call driver initiator. 
Z15 - Not used. 

Z16 - Uait for initiator nake present, then state 2. 
Z17 - Uait for conpletor nake present, then state 3. 



2 3 4 5 6 7 8 9 10 11 12 13 14 15 HNEP.ONIC 



0| OIACIRQI 0|nu| 0|IO|IR|NOIST| 0| State I DFLAG 

DUNK 



-I 



SYSDB relative pointer to the OIT for the next I 
device requesting this resource or service j 



SYSDB relative pointer to the first IOQ in I 
request list for this device. I 

..*—*—♦—♦— 4—4— ♦—♦— 4—4—4— 4—4— ♦--♦-- 1 

I 



DIOQP 



Logical device nunber 



-I 



DLDEV 
SYSDB relative pointer to Device Linkage Tablel DDLTP 

..+..+—«— 4 — ♦— ♦— ♦— 4~ ♦— ♦— ♦— ♦— ♦— ♦— '4— | 

SYSDB relative pntr to Interrupt Linkage Table] DILTP 

DSAVE 
DSERR 



RU|RU|SH|GR| |PF| 



-I 
lEOVIPPIIRI EI |PA| 

..+—4— +—*—+— 4— | 

Harduare error status. Set uhen the driver | 
detects an error. Uhenever <> 0, the driver I 
nonitor logs an I/O error and clears this uordj 



Bit is set at conpletion of tiner. 



Interrupt status for this unit. Set by the 
driver each tine it processes an interrupt. 



IOT I/////////////////I 



Phys. unit • 



DTIBE 
DSTAT 

DUNIT 
DRQST 



Holds the tine out request entry index uhile 
a tiner is active. I 

.-♦—4—4—4— 4~ 4— 4~ 4~ 4«— 4— 4— 4—4— ♦— ♦— | 

Error log. Contains 6 bytes of status fron | DDEVSTAT 
the previous operation. I 

..4—4—4— 4— 4—4— +—4—4—4—4—4—4—4—4— 
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,4P^v 
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DSAVE - Oevicc processing flags. 

RU - Indicates tape has been rewound. 

RO - Indicates a reuind/offline was perforned to allow 

a urite-ring nount. 
SH - Indicates a short read it in progress. After 
conpletion of the read, EOF is checked for and if 
not present, the data requested is transferred fron 
the short read buffer to the user'e buffer. 
Gft • Good retries on previous operation. 
PF - Indicates device is pout red up. 
EOV - enable check on 2 consecutive ECFe. 

- no check 

1 - enable 

2 - 1 EOF read 

3-2 consecutive EQFs encountered 
PP • Device pouerfaii processing flag. 

- Device pouerfaii process conplete. 

1 - 1st pass of device pouerfaii proceesing. 
IR - Innediate report status. 

- Innediate report is disabled. 

1 - Innediate report is enabled. 
EI - EOF processing indicator. 

- Last operation uas not a urite file nark. 

1 - Last operation uas a urite file nark. 

2 - Device buffered operations are being 

conpleted prior to issuing the second 
of a double urite file nark (EOF). 
PA - Pending abort processing. 
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DSTRT - Firet two bytee of device status. 
UORD 1 

Bit heaning 

End-of-file (EOF) 

1 Beginmng-of-tape (BOT)/Load-point (LP) 

2 End-of-tape (EOT) 

3 Recovered error (STE) 

4 Connand rtjtct 

5 File protect (not urite enabled; no urite ring) 

6 Un recovered error (HTE) 

7 Unit online 

8 GCR (6250 BPI Deneity) 

9 Unknown deneity 

10 Data parity error 

11 Timng error 

12 Tape runauay 

13 Door open 

14 Not used 

15 Imtediate report enable 

UORD 2 

Bit llcaning 



PE (1600 BPI Deneity) 
NRZI (800 BPI Deneity) 
Pouer restored 
KPIB Ccnnand Parity Error 
Position Un recovered 
Fornatter error 
Servo error 
Controller error 
8-10 Connand Reject detail 

000 - Null code 

001 - Reserved 

010 - Device Reject 

011 - Protocol Reject 

100 - Reserved 

101 • Prior error reject 

110 - Reserved 

111 - Self test failure 
Retry count. 



11-15 
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If ^RECOVERED ERROR 

41 - Tape velocity use out of specification. 

43 - Tape teneion use out of specification. 

45 - Rultiple tracks uert in error. Either two or rare 
tracks utn in error for a PE or NRZI urite, or tuo 
or rare tracks uere in error for a GCR urite. 

47 - Failure to verify a tape nark or density ID just uritten. 

48 • Noise on detect. Indistinguishable flux transitions uere 

detected uhile attenpting to detect a recorded block. 

49 - Data fornat error. Flux transitions were found or uere 

niesing in the appropriate tracks for a block detect. 

50 - Failure to identify tape following a reuind comand 

51 - Gap detected before end-of-data. The read fornatter 

dected a full tape uidth dropout uithin the data portion 
of a data block. 

52 - Data block dropout. R full tape uidth dropout uas 

detected uithin the preanble or postanble of a data 
block. 

53 - Redundancy check error. The read fornatter detected 

either a CRC, RCRC, IRC or reeidual error uhile reading 
or verifying a data block. 

54 - Read parity error. The read fornatter detected an 

unrecovered parity error uithin a data block. For PE 
this error could include nultiple tracks in error, and 
for GCR this error could also include a redundancy check 
error. (Buckhorn only). 

55 - ftbnornal connand abort, door opened (Rntelope only). 

57 • Haxinun skeu exceeded (Rntelope only). 

58 - Falee preanble or poetanble detected (Rntelope only). 

59 • Corrected data error on urite (Rntelope only). 

61 • Data block tineout. Could not detect the g*P following 

a data block. Could be caused by a record length longer 
than the drive supportes on read. 

62 • Tape nark dropout. R full tape uidth dropout uas 

detected uithin a tape nark. 

63 - Tape nark unverified. R tape nark uas detected which 

does not neet RNSI specifications in terns *»* *lu* 
transitions and erasure in the appropriate tracks. 

64 - Tape nark tineout. Could not detect the gap fcllouing 

a detected tape nark. 
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UORD 3 (left byte) 

The contents of this byte contains binary coded infornation 
regarding the specific error encountered. 

If COnnfiND REJECT 

5 - Device is urits protected when a write type connand was 

initiated. 

6 - Tape uas not tensioned when the connand uas queued. 

7 - Urite density connand given but requested density is not 

available (option not present). 
9 - The tape to be read was unidentifiable as to fomat. 
The density read my not be available, or the tape nay 
have an unreadable identifications field, or n*y be 
blank 

10 - The tape to be uritten on has not been identified as to 

fornat. R write Record, Urite File Hark, or Urite Gap 
connand was received but cannot be processed without a 
Urite Fornat connand if the tape uas unidentified at 
load point. 

11 - Drive not online. 

16 - R write fornat connand was issued but the tape ien't at 

load point. 
19 - R backward type connand (except a rewind connand) uas 

just initiated but the tape uas already positioned at 

BOT. 

22 - Rn inprcper connand sequence uas detected by the drive. 

23 - Protocol not synced. 

24 - The tape connand byte received uas unknown to the drive. 
31 - The length of a write record requested exceeded the 

size of the drive's data buffer. 
37 - Cannot urite pact 10 feet beyond end-of-tape. 
40 - Door open reject. The door uas opened during a lono gap 

while the tape wae beyond the end-of-tape n*rkT. Thie 

condition is non-retnable to prevent unspooling of the 

tape. 
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If POSITION UNRECOVEREO 

81 - Servo controller unresponsive. The servo uill not take 

data fron the raster controller. 

82 - Servo failed to reach the desired state rcqqueeted by 

the naster controller. 

83 • Servo shutdown. The servo eysten lost tape tension 

unexpectedly. 

84 • Servo controller hard failure. The servo controller has 

detected a hard failure uithin iteelf. 

85 - Servo protocol error. Rn invalid byte uas received by 

the eervo fron the naster controller. 

86 - R run tine error use detected by the eervo. 

87 - In position interrupt not received, hatter controller 

did not get the in poeition interrupt it expected. 

88 - No gap detected by the servo after reading or writing a 

data block or tape nark. 

90 - No BOT detected en load or reuind. 

91 • Speed out of specifications. 

92 - The desired state requested by the raster controller 

u*» invalid for the current context. 
94 - Tape positioning failure. 
If FORflflTTER ERROR 

101 - Buckhorn read fornatter unresponsive. The read fornatter 

did not reepond uith end of record status after a data 
block uae detected. 

102 - Buckhorn read fornatter hardware error. 

103 - Bad block type detected en a urite operation. 

104 - Eraee failure. Flux transitions uere detected in a 

portion of tape currently being eraeed. 

105 • No data detected after urite. 

106 - Tracks out of sync on urite verify. 

107 - Rntelope fornatter hardware error. 

108 - Rntelope fornatter unresponsive. 

110 - Fornatter byte count nisnateh uith data buffer. 
If CONTROLLER ERROR 

121 - Transaction ID nisnateh between eonrand eent to Device 

prog ran and the returned report. 

122 - No pending connand found for report received fron Device 

progran. 

123 - Invalid report nessage received fron Device progran. 

124 • Report queue overflow. 

125 - Unknoun connand received by Device progran. 

126 - Connand queue overflow. 

128 • Hissing end-of -record flag in data buffer. 
131 - Byte count nisnateh between putting a record into the 
data buffer and renoving it. 

133 - Processor handshake abort between HP-IB interface board 

and channel progran. 

134 - Unknown HP-IB interface exception detected. 

138 - Device progran firnware error. 

139 - Hardware utilitiee firnware error. 

140 - Channel progran fimuarc error. 
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If COflfWMO REJECT and PROTOCOL REJECT 

161 - Connand queue not enpty. Cannot acctpt ntu tapt 

connand or diagnostic requeot. 

162 - Request OSJ expected. 

163 - Request etatuf expected. 

165 - Unknoun unit select. 

166 - Tape connand secondary expected. 

167 - Oata byte expected. 

168 - Hissing EOI on tape connand data byte, self test nunber, 

or END connand data byte. 
170 - Connand phase protocol error for urite record. 

172 - Read record report phase protocol error. 

173 - Report phase protocol error. 

174 - Cold load sequence protocol error. 

176 - EMD "Complete" or "Complete-Idle" exptected. 
178 - ENO "Oata" expected. 

180 - Unknoun interface secondary connand. 

181 - Displaced data byte. 

184 - Interface loopback protocol error. 

185 - Run self test protocol error. 

188 - HP-IB connand parity error. 

189 - Reset by operator during a protocol sequence. 

190 - Device clear received. (Internal error code only.) 

UORO 3 (second byte) 

The sixth byte is used only uhen reporting transparent status of 
hard and soft errors uhile in mnediate report node. Uhen an 
innediate report urite has a soft error (retries utn necessary) 
or a hard error (urite failure) this byte indicates uhich 
connand had the error. It contains the nunber of connands sent 
and reported since the connand in question uas issued. If the 
innediate reported urite had a hard error, all of the connands 
issued after the failure also fail (they uill be aborted by the 
device). Thus on a hard error, this byte actually indicates the 
nunber of preceeding connands that failed. For non-transpartnt 
status, this byte uill aluays be sere. 
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DFLAG 

RC 


- Flags 
RCTWE 


RQ 


REQUEST 


no- 


nUNIT 


lo 


I0PR08 


IR 


IRK 


NO 


NOTROY 


ST 


STURIT 



STRTE 



and request state. 

- fl nonitor is currently servicing this device. 

- R service requttt is ptnding uhile the nonitor it 
active. 

- This device it en a milti-unit controller. 

- Rn I/O Channel Pregran ie running for this device. 

- Rn interrupt or response has occurred for thie device. 

- Go to state Z10 after Idle Channel Progran is started. 

- The device nonitor is starting an Idle Channel Progran 
for this device; there is no IOQ associated uith this 
type of request. 

- State of the device nonitor; specifies the next action 
to be taken in SIODO in servicing the request: 

ZO - Start neu request. 

1 - Not used. 

2 - Call driver initiator procedure. 

3 - Call driver cenpletor procedure. 

4 - Not used. 

5 - Process request conpleted. 

6 - Initiate device recognition sequence. 

7 - Start operator intervention uait. 

10 - Hait for interrupt (operator intervention) 

restart at state 0. 

11 • Uait for data segnent freeze, then state 2. 

12 - Uait for driver initiator to be frozen, then 

allocate controller (state 2). 

13 - Uait for I/O conpletion interrupt, then etate 3. 

14 - Uait for controller, then call driver initiator. 

15 - Not used. 

16 - Uait for initiator nake preeent, then state 2. 

17 - Hait for conpletor nake preeent, then state 3. 

DSPVE - Device processing flags. 
RU RUBIT - Indicates tape has been reuound. 
RU RUUNLD - Indicates that a reuind/unload uae performed to allou t 

urite- ring mount. 
Sh SHORT - R short read ia in progreet; after conpletion of read, 

EOF is checked for and if not present, the requested 

bytes are transferred fron the short-read buffer to the 

user's buffer. 
DC DSFlAG - Transfer used data chaining - used for conputing the 

transnisfcion log. 
PF POUER - Device pout- up indication. 
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PIT for 7976 naonetic Tape 

There is one OIT per physical device. If a physical device represents nore 
than one logical device, the logical device nunber is obtained fron the IOQ 
elenent. The folloumg diagran shous the OIT used for the nag tape driver. 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 UNEnONlC 

ZOI 0| OIRCIRQI OIHUI OIIOIIRI 0| 0| 0| STRTE IDFLAG 

|..|..|-.|~|~|~|~|~|~|--|~|--| 1 

11 SYS08 RELATIVE POINTER TO THE OIT FOR IDUNK 

I THE NEXT DEVICE REQUESTING THIS I 

| RESOURCE OR SERVICE I 

| 1 

21 SYSOB RELATIVE POINTER TO THE FIRST IOIOQP 

| IOQ IN THE REQUEST LIST FOR I 

| THIS DEVICE I 

j 1 

3| LOGICAL DEVICE NUHBER IDLDEV 

I 1 

4| SYSD8 RELATIVE POINTER TO THE DEVICE IDOLTP 

| LINKAGE TRBLE I 

| 1 

5| SYSDB RELATIVE POINTER TO THE IDILTP 

| INTERRUPT LINKAGE TABLE I 

6|RU|RU|SHi IDCIPFI IDSAVE 

7| ' HRROUARE ERROR STATUS IDSERR 

| SET UHEN THE DRIVER DETECTS RN ERROR i 
| UHENEVER <> 0, THE DRIVER HQNITOR | 
| LOGS RN I/O ERROR RND CLEARS THIS UORO I 

10| BIT IS SET RT COHPlfTION OF TWER |DTIht 

11| INTERRUPT STATUS FOR THIS UNIT IDSTRT 

| SET BY THE DRIVER EACH Tint IT I 

| PROCESSES RN INTERRUPT I 

, 1 j 

121 IOT | I PHYSICAL UNIT i I 

| 1 1 1 

131 HOLDS THE TIRE OUT REQUEST ENTRY INDEX IDRQST 

| UHILE R TWER IS RCTIVE I 

1 

14| ERROR LOG - CONTAINS 5 VALID BYTES IOLOGERROR 

| OF STATUS I 

, 1 
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OSTAT - Nag Taoe Controller Statue 

BITS USE 

End-of-filt (EOF) 

1 Beginning-of-tape (BOT) / Load Point (LP) 

2 End-of-tape (EOT) 

3 Single track error (not logged for reads) 

4 Connand reject (reject) 

5 File protect (not urite enabled; no urite ring) 

6 Rultiple track error (nTE) 

7 Unit online 

8 GCR (6250 6PI deneity) 

9 Unit nunber (P.S8) 



10 Unit nunber (LSB) 

11 Tining error 

12 Tape runaway 

13 Reuinding * 

14 Unit busy ** (reported at unit not ready) 

15 Interface busy * 
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PIT for 9144 ^rtr^dat tant drive 
uord 12 3 4 5 6 7 



8 9 10 11 12 13 14 15 
.4—4—4. 



ITMOSIRCIRQI 01 01 0|IQ|IR|HO|ST| 01 State 
j— 4— ♦—♦—♦—♦—♦—♦— ♦--♦«— ♦—♦—♦—♦—♦— ♦— 
| SYSOB rtlativt pointtr to tht OIT for tht ntxt 
I dtvict requtsting this rtsourct or tcrvict 
I— 



Pointtr to tht eurrtnt 109 



Logical dtvict nunbtr 



SYSOB rtlativt pointtr to Dtvict Linkagt Tablt 



SYSD8 rtlativt pntr to Inttrrupt Linkagt Tablt 



Stt to -1 uhtn systtn poutrfail occurs. 
.-♦—♦— ♦—♦—♦—♦--♦—♦—♦—♦•-♦--♦— ♦—♦—♦• 
Harduart trror statu*. Stt uhtn tht drivtr 
dtttcti an trror. Uhtntvtr <> 0, tht drivtr 
nonitor logs an I/O trror and cltan thit word 
,-♦—♦—♦—♦—♦—♦—♦— ♦—♦—♦--♦—♦— ♦--♦—♦— ' 
indtx of first rtqutst in tht qutut 



indtx of last rtquttt in tht qutut 

—4— 4.. 4— 4— 4— 4— -4— -♦— 4— 4— 4--4«— 4~4-»4« 

IOT I I Physical Unit • 

..4.. 4—4— 4--4--4~ 4— ♦--♦—♦— ♦—♦--♦— ♦--♦- 

LKlIGlini I SUBSTRTE 



High ordtr logical stctor addrtss of bad block 



Lou ordtr logical stctor addrtss of bad block. 



Bytt transftr ltft uhtn bad block occund 

—4— 4— 4— 4~4-»4— 4-"4"4— 4— 4~4"-4"4""4- 

Harduart loggtd tmr status - CPVfl (0). 



Rtlativt offstt of channtl progran abort. 



22 



I Rccun bytt count of transftr > 6144 bytts. 
J..4..4.. 4— ♦--♦—♦—♦—♦—♦—♦—♦— 4— ♦— ♦-« 



I Otvict status (20 bytts), trroro loggtd 

|-4-4-4-< 

I 



—4—4—4—4- 



j — 4— 4— 4— 4~4— 4— 4~4- 

I 

J -.4.-4— 4—4— ♦— 4~4~4-« 



,4—4-4—4—4— 4— 



nNEMNIC 

DFLRC 

DUHK 

DIOQP 
DLDEV 
DOLTP 
DILTP 
DSTRT 
DSERR 

DQHERD 
OQTRIL 
OUNIT 

omsc 

D8RDBLK1 

D8R0BLK2 

08R0XFER 

DLOGERROR 

CSIOPSTOP 

DBYTECHT 

OSTRTUS 



I/O 



DFLAG • Dtvict flags and rtqutst statt. 

Tn - Stt if dtvict is a ttmmal 

OS - If Tn « and this bit is stt thtn dtvict it 

a disc, othtruist dtvict dtptndtnt. 
RC - fl nonitor is currently strvicing this dtvict. 
RQ - fl strvict rtqutst is ptnding uhilt tht nonitor 

is activt. 
10 - An I/O channtl progran is running for this 

dtvict. 
IR - Rn inttrrupt or rtsponst has occurrtd for this 

dtvict. 
NO - Hot rtady, start idlt channtl progran thtn go to 

statt Z10. 
ST - Tht dtvict nonitor is starting an idlt channtl 

progran for thit dtvict. Thtrt is no IOQ 

associattd uith this statt. 
STATE - Statt of tht dtvict nonitor. Sptcifits tht next 

action to bt taktn by SIODH in strvicing tht 

rtqutst: 

- Start a ntu rtqutst. 

1 - Not ustd. 

2 - Call drivtr initiator proctdurt. 

3 - Call drivtr conplttor proctdurt. 

4 - Hot ustd. 

5 - Rtqutst conplttt. 

6 - Initiatt dtvict recognition stqutnet. 

7 - Start optrator inttrvtntion uait. 

Z10 - Uait for inttrrupt (optrator inttrvtntion), 

restart at statt 0. 
Z11 - Uait for data stgntnt freeze, thtn statt 2. 
Z12 - Uait for drivtr initiator to bt frozen, 

thtn allocatt controlltr (statt 2). 
Z13 - Uait for I/O conplttion inttrrupt, thtn 

statt 3. 
Z14 - Uait for controlltr, thtn call drivtr 

initiator. 
Z15 - Hot ustd. 
Z16 - Uait for initiator nakt prtstnt, thtn 

state 2. 
Z17 - Uait for conplttor nakt prettnt, thtn 

statt 3. 

DQHK, 
DQHERD, 
DQTRIL, 
DUHIT - Not ustd. 
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DniSC - Hitctllantout dtvict infornation. 

IK - Lock flag dtnoting unload ttatus of tht 
dtvict. 

- Rllou optrator unload of tht volimt. 

1 - Dtny optrator unload of tht volunt. 
IG - Ignore unexpected inttrrupt flag. 

IH - Inntdiatt report. 

- Disabltd. 

1 - Enabled. 

SUBSTRTE - Idlt channtl progran ttatt. 

- Hornal idlt ehanntl progran uait. 

1 - Idlt rtqutst bting strvictd uait. 

DBRDBLX1 - High ordtr logical stctor address of bad block 
tncounttred. 

DBRD8LK2 - Lou ordtr logical ttctor address of bad block 
tncounttred. 

DBADXFER - Bytt transftr ltft uhtn bad block occured. 

DLOGERROR - CPVR (0) loggtd on harduart trror status. 

DSIOPSTOP - Rtlativt offttt location of channtl progran uhtn 
trror in CPVR (0) occured. 

DBYTECHT - Rccunnulativt transftr count for transftre greattr 
than 6144 bytts. 

DSTRTUS - 20 byttt of status loggtd uhtn a status trror occurs. 
(Refer to CS/80 Instruction Set nanual for deecription. ) 
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PIT for HP9145 Cartridoe Taoe Drivt 
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uord 

1 

2 
3 
4 
5 
6 
7 

10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



ITniOSIRCIRQI 0| Ol OIIOIIRINOISTI 0| Statt 



SYSOB rtlativt pointtr to tht DIT for tht ntxt 
dtvict requesting this rtsourct or strvict 



Pointtr to tht current IOQ 



Logical dtvict nunbtr 

..4— 4— 4— 4—4— ♦—♦—♦—♦--♦—♦— ♦— 4—4—4-- 

SYSDB rtlativt pointtr to Dtvict Linkagt Tablt 



SYSD8 rtlativt pntr to Inttrrupt Linkagt Tablt 
.. 4— 4—4—4— 4— 4—4—4—4—4— 4—4—4— 4—4— 
Stt to -1 uhtn tysttn poutrfail occurs. 



Harduart trror status. Stt uhtn tht drivtr 
dtttctt an trror. Uhtntvtr <> 0, tht drivtr 
nonitor logs an I/O trror and cltart this uord 



index of first rtquttt in tht qutut 



indtx of last rtquttt in tht qutut 



IOT | IRVI 
LK|NR|M|PI| isLinPJ 



| Phytical Unit • 
— 4— 4— 4—4— ♦-- • 



| SUBSTRTE 



High ordtr logical ttctor addrest of bad block 

,.4— 4— 4— 4— 4— 4— 4—4—4—4—4— 4— 4—4—4— 

Lou ordtr logical stctor address of bad block. 



•4—4- 



Bytt transftr ltft uhtn bad bloek occurred 

—4—4—4—4—4—4—4—4—4—4—4—4—4—4—4-- 

Harduart loggtd trror ttatus - CPVR (0). 

..4— 4— 4— 4— 4— 4— 4— 4— 4—4— 4— 4~4~4— 4- 

Rtlativt offset of channtl progran abort. 



Rccun bytt count of trantftr > 6144 bytts. 



Otvict status (20 bytts). trrors loggtd 



ustd by Rtqutst Status Function 



hUEflONK 

DFLAG 

DUNK 

DIOQP 
DLDEV 
DDLTP 
DILTP 
DSTRT 
OSERR 

OQHERO 

DQTRIL 

DUHIT 

DHISC 

D8R0BLK1 

DBRDBLK2 

DBADXFER 

DLOGERROR 

CSIOPSTOP 

D8YTECNT 

OSTRTUS 
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Device Pouerfail Status (4 uords) 



used by tht Return Poutrfail Status Utility I 



| DPFSTRTUS 
-I 



.-♦—♦--♦--♦- 



..+..+.•+—+>- ♦— ♦-• 



-♦-I 



OFLflC - Davice flags and request state. 



Tn - Set if device is a terninal 

DS - If TH « and this bit is set then device is 

a disc, otht raise device dependent. 
AC - R nenitor is currently servicing this device. 
RQ - R service request is pending uhile the nonitor 

is active. 
10 - Rn I/O channel progran it running for this 

device. 
IR - Rn interrupt or response has occurred for this 

device. 
MO * Not ready, start idle channel progran then go to 

state X10. 
ST - The device nonitor is starting an idle channel 

progran for this device. There is no 100 

associated uith this state. 
STATE - State of the device nonitor. Specifies the next 

action to be taken by SIODfl in servicing the 

request: 

- Start a neu request. 

1 - Not used. 

2 - Call driver initiator procedure. 

3 - Call driver continuator procedure. 

4 - Not used. 

5 - Request conplete. 

6 - Initiate device recognition sequence. 

7 - Start operator intervention uait. 

X10 - Uait for interrupt (operator intervention), 

restart at state 0. 
Z11 - Uait for data segnent freeze, then state 2. 
Z12 - Uait for driver initiator to be frozen, 

then allocate controller (state 2). 
X13 - Uait for I/O completion interrupt, then 

state 3. 
X14 - Uait for controller, then call driver 

initiator. 
X15 - Not used. 
X16 - Uait for initiator nake present, then 

state 2. 
X17 - Uait for continuator nake present, then 

state 3. 
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DUNK, 
DQHERD, 

OOTRIL - Not used. 
DUNIT - IOT 
RV 



Unit 



I/O Type. 01 for this device. 

- RVR flag. Set by driver, tested by 
SIODfl. 

1 - Driver can detect unexpected 
(RVR) conditions and uill exit to 
SIOOH State 6 uhen safe. SlOOh 
should bypass State 6 uhen called 
fron GIP. Neu functionality. 

- Driver cannot detect RVR condi- 
tion. SIODfl should honor a State 
6 call fron GIP. Previous func- 
tionality. 

- Unit nunber for nulti-unit control- 
lere. Rluaye for this driver. 



{* 



I/O 



D8YTECKT 



• Rceunnulative transfer count for transfers greater 
than 6144 bytes. 



DSTRTUS - 20 bytes of status logged when a status error 
(Refer to CS/80 Instruction Set nanual for 
a norc detailed description.) 

The following table denotee the only valid status bits 
that can be eet by Excalibur. 

UORO : IDENTIFICATION ERRORS FIELD 



DfllSC - Hiscellaneous device information. 

LK - Lock flag denoting unload status of the 
device. 

- Rllou operator unload of the volune. 

1 - Deny operator unload of the volune. 
NR - Not Ready. Renenbers the state of 

DIT'DEV'NOT'RDY the last tine status 
uas read fron the device. Used for 
detecting off-line transitions, 
in - Inntdiate report. 

- Disabled. 

1 - Enabled. 

PI - Pending Interrupt. Set if a tape cones 
online uhile the driver is processing 
an IOQ in the continuator. This is 
checked before the driver enters IDLE 
in the initiator. If set, the driver 
uill return unexpected interrupt up to 
SIODfl. This uill RVR the tape. 

SL - Spares Lost. Set if no IOQs trt being 
processed and a pfail has occurred 
such that the spares table is lost. 
If this is set uhen the next IOQ is 
processed, that IOQ' STAT uill be set 
to X274. 

IIP - Rust Pouerfail Next I/O. Set if no I/Os 
are being processed and a pfail has 
occurred such that data uas lost fron 
the I/O. If this is set uhen the next 
IOQ is processed, that IOQ* STAT uill 
be set to Z63 POUERFRIL' ABORT. 

SUBSTATE - Idle channel progran state. 

- Nomal idle channel progran uait. 

1 - Idle request being serviced uait. 
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bite Reaning 



0:4 
4:4 
8:8 



Volune Nunber 
Unit Nunber 
Statue Pending 



Driver Variable Nane 

oit'first'stat'uoro 
dit'first'stat'uoro 
dit'unit'attention 



UORO 1 : REJECT ERRORS FIELD 
bit* Reaning 



2 
5 
6 

7 
8 
9 

10 
12 



Channel Parity Error 
Illegal Opcode 
llodule Rddrcssing 
Address Bounds 
Paraneter Bounds 
Illegal Paraneter 
Ressage Sequence 
hessage Length 



UORO 2 : FRUIT ERRORS FIELD 

bit* Reaning 

6 Unit Fault 

8 Diagnostic Result 

14 Pouerfail 

15 Retransnit 



Driver Variable Nane 

DIT'CHRN' PARITY' ERR 
DIT'ILL'OPCOOE 
DIT'nODULE'ROOR'ERR 
DIT'RDDR' BOUNDS 
OIT'PRRRnETER'BOUND 
DIT'ILL'PRRAnETER 
DIT'ILL'nSG'SEO 
DIT'flSG' LENGTH' ERR 



Driver Variable Nane 

DIT'UMT'FRULT 
OIT'DIRG'FRIL 
OIT'DEV'POUERFAIl 
DIT'RETRRNSMT 



UORD 3 : RCCESS ERRORS FIELD 
bit* (leaning 



Driver Variable Nane 



1 


Uninitialized hedia 


DIT'UMIMITTEDIR 


2 


No Spares Available 


DIT'SPRRE'UNRVRIL 


3 


Not Ready 


DIT'DEV'NOT'RERDY 


4 


Urite Protected 


DIT* URITE' PROTECT 


9 


Unrecoverable Oata 


DIT'UNRECOV'DRTA 


11 


End Of File 


OIT" END' OF' FILE 


12 


End Of Volune 


DIT'END'OF'VOLUflE 



UORD 4 : INFORItflTIQN ERRORS FIELD 



bit* Reaning 




1 
7 
11 



Operator Req Release 
Diagnostic Req Release 
Ruto Sparing Invoked 
Recoverable Data 



Driver Variable Nane 

DIVI'OPR'REL'REO 
DIT'I'DIRG'REL'REQ 
DIT'DEFECT'BLK'SPRRE 
OIT'RECOV'DRTR 



UORDS 5,6,7,8,9 : PRRRHETER FIELD 

Refer to the CS'80 Hanual for the neaning of theee bytee. 
The bytes depend upon uhich error is reported in the 
etatus bits. 

DPFSTATUS - This status is returned by the Return Pouerfail 
Status Utility after a device pouerfail. It ie 
valid ONLY directly after the QSTRT«2 report ie 
received fron the device. Do not interpret thie 
status if a pouerfail has not just occurred. 

The Utility returns 7 bytes at preeent, but 
4 uords trt set aside for it. 



sm^ 
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I/O 



BYTE* 




(leaning 



3 - 6 



Total Nunber of bytea retumid by Utility, 

including bytt (currtntly « 7) 

Driver Variable N«nt : OIT'PFfllL' NUf1' BYTES 

Pouerfaii Status flag 

Drivtr Vanablt Nana : DIT'PFRIL'PFSTRTUS 

: If no pfail hat occurred 

(nedia loadtd u/no pfail) 

1 : Pfail occurred, but no tape LQRDed 

(tape could be present or UNLQRDing 
but it is not LOflOed) 

2 : Pfail occurred and a tape has LORDed 

Successfully 

3 : Pfail occurred, tape attenpted to LORD, 

but LORD failed 

Pouerfaii Data Lots Flag 

Driver Variable Nane : DIT'PFRIL'DRTR'LOSS 

: If no data uas lost during last pfail 

1 : Host data in buffer uas not written to 

nedia after pfail (data lost) 

2 : Spares table uas not updated to tape after 

pfail (this is FRTRL) 

Address of First Kott Block Not Uritttn 

Driver Variable Manet : 

OXT' PFAIL* HOST 'RDDR1 ... DIT'PFRIL'H0ST'RD0R4 

If Byte*2 ■ 1 then thit it the logical hott 
block addrett of the firtt block not uritten 
to tape after the pouerfaii. 

If Bytt#2 « or 2 then thit uill be zero. 
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OF LAG - Device flagt and requttt ttate. 



I/O 



I/O 

PIT for HP3540 1 C^rtridot Tape Drive 

word 12 3 4 5 6 7 8 9 10 11 12 13 14 15 




1 

2 
3 
4 
5 

6 
7 

10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 



|Tn|DS|RC|RQI 0| 0| 0|IO|IA|NO|ST| 0| State 
!_.♦..♦— ♦.-♦--♦--♦--♦--♦—♦--♦—♦—♦--♦--♦—♦— I 

I SYSDB relative pointer to the DIT for the next I 
I device requesting this resource or service I 
| — ♦ — ♦ — ♦ — ♦--♦ — * — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — ♦--! 
I Pointer to the current IOQ ! 
( — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — ♦ — I 
Logical device nunber 



I 
SYSDB relative pointer to Device Linkage Table I 



SYSDB relative pntr to Interrupt Linkage Table I 

._4—4~4--4 — 4"4--4"4~4— 4—4—4— 4—4—4— | 

Set to -1 uhen systen pouerfail occurs. I 



Harduare error status. Set uhen the driver I 
detects an error. Whenever <> 0, the driver | 
nonitor logs an I/O error and clears this uordj 

.♦—♦—♦—♦—♦—♦—♦—♦—♦—♦—♦—♦—♦—♦— | 
index of first requett in the queue I 

.4— 4— 4— 4— 4— 4— 4— 4— 4— 4— 4— 4—4—4— | 



index of latt requett in the queue 



IOT | | RV| AC I RL I I Physical Unit ft I 

.4— 4— 4— 4— 4— 4— 4— 4— 4— 4— 4— 4— 4—4— 4— | 

iLK|NR|in|PI|AG|LU|nP| I SUBSTATE I 

— 4— 4— 4— 4"4— 4— 4— 4— 4— 4— ♦—♦--♦— 4—4— | 

High order logical sector address of bad block | 

—4—4.-4—4—4—4— ♦--4— 4—4—4—4—4—4—4— | 

Lou order logical eector address of bad block. I 
—4—4— 4.. 4.. 4— 4—4—4—4—4—4—4—4—4—4— I 
Byte transfer left uhen bad block occured I 

—4— 4— 4— 4— 4— 4— 4— 4— 4— 4— ♦--♦--♦--♦--♦-- 1 

Harduare logged error status - CPVA (0). I 

— 4— 4— 4— 4— 4— 4— 4— 4— 4— 4>~4— 4— 4— 4— 4— | 

Relative offset of channel progran abort. I 

—4—4—4—4—4—4—4— 4—4— 4— 4—4— .4— 4.-4.. J 

Accun byte count of transfer > 6144 bytes. I 

-4— 4— 4— 4—4— 4—4—4— ♦— | 

I 

•4— 4— 4— 4— 4— ♦— 4~4— ♦— | 

Device status (20 bytes), errors logged I 

,-4— 4—4— 4—4— 4— 4—4— 4— 4— 4— 4— 4— 4~ 4— | 

I 

-4—4—4— | 



flNEnONIC 

DFLAO 

DUNK 

DIOQP 
DLDEV 
DDLTP 
DILTP 
DSTAT 
DSERR 

DQHEAD 
DQTAIL 
DUNIT 

onisc 

DBADBLK1 

DBADBLK2 

DBADXFER 

DLDGERROR 

CSIOPSTOP 

OBYTECNT 



..4— 4._4— 4— 4— 4.~4— 4— 4.. 
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I/O 



Tn 

OS 



RC 
RO 



STRTE 



• Set if device it a ttrninel 

- If Tn • and thit bit it tet then device it 
a ditc, otherwise device dependent. 

- R nonitor it currently servicing thit device. 

- R service requett it pending uhile the nonitor 
it active. 

- Rn I/O channel progran it running for thit 
device. 

- Rn interrupt or response has occurred for thit 
device. 

• Not ready, start idle channel progran then go to 
ttate Z10. 

• The device nonitor is ttarting an idle channel 
progran for thie device. There ie no IOQ 
attoeiated uith thit ttate. 

- State of the device nonitor. Specifies the next 
action to be taken by SIODfl in servicing the 
requett: 

- Start a neu requett. 

1 - Not uted. 

2 • Call driver initiator procedure. 

3 - Call driver conpletor procedure. 

4 - Not uted. 

5 - Requett cenplete. 

6 - Initiate deviee recognition sequence. 

7 - Start operator intervention wait. 

7.10 - Uait for interrupt (operator intervention), 

rettart at ttate 0. 
Z11 - Uait for data tegnent freeze, then etate 2. 
Z12 - Uait for driver initiator to be frozen, 

then allocate controller (etate 2). 
X13 - Uait for I/O completion interrupt, then 

state 3. 
Z14 • Uait for controller, then call drivtr 

initiator. 
Z15 - Not used. 
Z16 - Uait for initiator neke present, then 

state 2. 
Z17 - Uait for conpletor neke present, then 

state 3. 



DUNK, 
DQHERO, 
DQTAIL - Not used. 



«09421» 



DUNIT - IOT - I/O Type. 01 for thie device. «09421» 

RV - RVR flag. Set by driver, tested by «09421» 

SIODfl. «09421 » 

1 - Driver can detect unexpected «09421» 

(RVR) conditione and uill exit to «09421» 

SIODfl State 6 uhen safe. SIODfl «09421» 

should bypatt State 6 uhen called «09421» 

fron GIP. Neu functionality. «09421» 

- Driver cannot detect RVR condi- «09421» 

tion. SIODfl should honor a State «09421» 

6 call fron GIP. Previous func- «09421» 

tionality. «09421» 

Unit - Unit nunber for nulti-unit control- «09421» 

lert. Rluayt for thit drivtr. «09421» 

RC - Thit bit it tht Releaec eount bit. 

It is used to count hou mny releate 
connands have been ttnt to the flerlin. 
It uill either be a or a 1. 

- No releate eoimand hat ytt been 

sent to the flerlin. 

1 - R releate connand hat ben tent to 

the flerlin. 
Thit bit it to inture that ue never eend 
eend «ore than tuo releases. 
RL - These are the Release connand bits. 
Ue can send a Release to the flerlin 
fron three areas and RL keeps track of 
uhere Release uae sent fron. 

- No Release connand eent. 

1 - Release sent fron Initiator se. 

2 - Release sent fron Continuetor. 

3 - Release sent at a function code. 
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I/O 



DMSC - Hiscelianeeus device information. 



LK 



LU 
HP 
SUBSTRTE 



Loch flag denoting unload ttatut of the 
device. 

- Allou operator unload of the volune. 

1 - Deny operator unload of the volune. 

- Not Ready. Renenbers the state of «09421» 
DIT'DEV'NOT'RDY the last tine status «09421» 
uas read fron the device. Used for «09421>> 
detecting off-line transitions. «09421>> 

- Innediate report. 

- Disabled. 

1 - Enabled. 

- Pending Interrupt. Device cane on «09421» 
line uhile driver uas uaiting on con- <<09421>> 
nand conpletion (i.e., not in idle <<09421» 
CP). On line interrupt uas used to <<09421>> 
conplete connand, so SIODn didn't «09421» 
uake DEVREC. The interrupt also set <<09421» 
this bit. If the bit is set uhen <<09421» 
SIODH starts the idle CP, ue return «09421» 
the Unexpected Interrupt state so <<09421>> 
that SIOOH uill uake DEVREC. «09421» 

- Release Granted. Device requested a «09421» 
release and driver O.K.'ed it. If <<09421» 
this bit is set uhen ue are ready to <<09421>> 
start the idle CP, ue issue a status <<09421>> 
request CP instead. This is because <<09421>> 
the device does not set a DSJ of 2 «09421» 
uhen conpleting the release due to «09421» 
coning on line! It needs an addition- <<09421>> 
al connand to do so. The status re- «09421» 
quest CP ensures that ue finish all «09421» 
on line processing before ue exit. <<09421» 

- last operation is a URITE. «J9456» 

• Hust Pouerfail the next operation. «J94S6» 

• Idle channel progran state. 

- Nornal idle channel progran uait. 

1 - Idle request being serviced uait. 



I /0 



DBRDBLK1 - High order logical sector address of bad block 
encountered. 

0BRD8LK2 - Uu order logical sector address of bad block 
encountered. 

DBRDXFER - Byte transfer left uhen bad block occured. 

DLOGERROR - CPVfl (0) logged on harduare error status. 

OSIOPSTOP - Relative offset location of channel progran uhen 
error in CPVR (0) occured. 

DBYTECNT - Rccunnulative transfer count for transfers greater 
than 6144 bytes. 

DSTRTUS - 20 bytes of status logged uhen a status error occurs. 
(Refer to CS/80 Instruction Set nanual for description.) 
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Card Reader PIT 



12 3 4 5 6 7 8 9 10 11 12 13 14 15 

|..|..|...|— l-IH-l 1— I 1 — I— I— I— l—l— 

Z0| 0| OIRCTIREQI 01 0| I I/O I IRK | RER0 1 NR| I ITSTATE OfLRC 
III | III IPAOGI lOOHEinSGI I 

l-l-l— I— l-l-l-l 1— I 1— l-l , MTUI , 

1| DITP LINK TO NEXT PIT IDLIMK 



I- 
21 



IOQP POINTER TO 1st REQUEST 



LOGICAL DEVICE NUHBER 



I 



10j 
11 



I 



DRIVER UNKRGE TABLE POINTER 



INTERRUPT LINKAGE TABLE POINTER 



(SEE BELOU) 



ERROR STATUS IF NOT 



REQUESTED UORO COUNT 



-I- 



I 12 IOT | 



PHYSICAL UNIT • 



DIOQP 
DLDEV 
DDLTP 
OILTP 
DSTAT 
DSERR 
OTME 
DTRQX 
DUNIT 



DSTAT bits: 




BIT * 


SIO OX 




BIT 1 ■ 







BIT 2 - 


Interrupt pending 




BIT 3 « 


Tining error 




BIT 4 ■ 


Light dark check 




BITS 5-6 


■ 00 Colurm binary node 
01 Unused 
10 Packed binary node 






11 Hollerith-to-ASCII node 


BIT 7 « 


Conpare error 




BIT 8 « 


EOF detected 




BITS 9-10 » 00 Nornal 






01 Hopper enpty 






10 Unused 






11 Stacker full 




BIT 11 ■ 


Invalid Hollerith 




BIT 12 ■ 


Pick fail or notor check 




BIT 13 « 


Test 




BIT 14 « 


Trouble 




BIT 15 « 


Not ready 
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Card Reader PIT Field Definitions 

DFLRG - Flags and device state. 

ACTIVE - ftonitor is currently active servicing this device. 

REQUEST - Service for this device uas requested uhile the 
nonitor uas active. 

IOPROG - SIO progran in progress. 

IAK - Interrupt occurred or request aborted or preenpted. 

RERDDONE - Previous read resulted in an EOF uith a backup save 
requested; the data has been saved in an auxiliary 
buffer and uill be passed back on the next read 
request. 

NRHESSAGE - Set uhen a not ready nessage has been issued, and 
cleared uhen the reader is found ready; used to 
prevent nultiple Not Ready neesages uhen pouer is 
turned on. 



NSTATE 



> Nonitor State; see SIODN specifications for details. 



DUNK - 

DIOQP • 

DLDEV • 
UNIT ■ 
DDLTP • 
DSTAT ■ 

DSERR - 

DUCNT 
DUNIT 



- SYSDB relative pointer to the DIT for the next device 
requesting service for this resource. 

- SYSDB relative pointer to the first IOQ elenent in the request 
list for this device. 

• Logical device nunber. 

• Unit nunber of device. 

- SYSDB relative pointer to driver linkage table (DIT). 

- Device interrupt status; contains the device interrupt statue 
at the last interrupt (See harduare ERS for details). 

- Device interrupt error statue; if not lero, then it holds the 
device interrupt status fron an operation uith an erroneous 
conpletion status (Causes SIODn to log an error). 

- Holds the requested transfer count in uorde. 

- I/O systen type and unit nunber. 
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Dtvict Information Tahlt for HP-IB Card Reader 



Thtrt it one OIT per physical dmct. If a physical dtvict rtprtstntt nore 

than ont logical dtvict, tht logical dtvict nunber is obtaintd fron tht IOQ 

tltntnt. Tht following dug ran shous tht DIT used for tht card rtadtr 
driver. 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 flNEHOWC 
|._ M _-,..|..|H--I--I--I--I~IH--M--I 
Z0| 01 OIRCIRQI OinUl 0|IQ|Ifl|NO|ST| 0| STRTE DFLR& 

l-l-l-l-l-l-l-l-l-l-l-l-l 

1 1 SYSDB RELATIVE POINTER TO THE OIT DUNK 
| FOR THE NEXT DEVICE REQUESTING 
| THIS RESOURCE OR SERVICE 

21 IOQ TRBLE RELATIVE INDEX TO THE FIRST 
t IOQ IN THE REQUEST LIST FOR THIS 
I DEVICE 

31 LOGICAL DEVICE NUNBER 
| 

4| SYSDB RELATIVE POINTER TO DEVICE 
! LINKAGE TRBLE 

51 SYSDB RELATIVE POINTER TO THE 
| INTERRUPT LINKRGE TRBLE 

6|RD|RF| 

7| HARDWARE ERROR STATUS 
| SET UHEN THE DRIVER DETECTS AN 
I ERROR. UHENEVER <> 0, THE DRIVER 
| ItONITOR LOGS RN I/O ERROR AND 
| CLEARS THIS UORD 
| 

101 NOT USED 

11| REQUEST UORD COUNT 

121 IOT | | PHYSICAL UNIT M 
, 1 1 

131 DEVICE STATUS - READ FRON DEVICE 
I DURING EACH EXECUTION OF THE 
I CHANNEL PROGRRN 

14| LOGGING UILL BE DONE FRQH HERE 
, 



DIOQP 

DLDEV 
DOLTP 

DILTP 

DSAVE 
DSERR 



DTME 
DUCNT 
DUNIT 
OSTAT 

DLOGERROR 
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DFLAG- 



Flags and request statt: 

RC ACTIVE - A nonitor is currently strvicmg this dtvict. 

RQ REQUEST - R strvict rtqutst is ptndmg uhile tht nonitor 

is activt. 
HU flUNIT - This dtvict it on a nulti-unit controlltr. 
10 IOPROG - Rn I/O Channtl Progran is running for this dtvict. 
IR IRK - An mttrrupt or responst has occurrtd for this 

dtvict. 
NO NOTRDY - Go to statt Z10 afttr Idle Channtl Progran is 

started. 
ST STUflIT - The device nonitor is starting *n Idle Channel 

Progran for this device; there is no IOQ 

associated uith this type of request. 

STATE - State of the device nonitor - specifies the next action to be 
taken in SIQDfl in servicing the request: 
XO - Start neu rtqutst. 

1 - Not ustd. 

2 - Call driver initiator procedure. 

3 - Call driver conpletor procedure. 

4 - Not used. 

5 - Process request eonpleted. 

6 - Initiate device recognition sequence. 

7 - Start operator intervention uait. 

10 - Uait for interrupt (operator intervention) 

restart at state 0. 

11 - Uait for data segnent freeze, then state 2. 

12 - Uait for driver initiator to be frozen, then 

allocate controller (state 2). 

13 - Uait for I/O conpletion interrupt, then state 3. 

14 - Uait for controller, then call driver initiator. 

15 - Not used. 

16 - Uait for initiator nake present, then state 2. 

17 - Uait for conpletor nake present, then statt 3. 

DUNIT - I/O systtn typt and unit nunbtr. 



,!^^^^ 



IOT I/O TYPE 



I/O Systtn typt: 

= Stries II/III I/O systen 

1 » HP-IB Systens 

2 * Unused 

3 ■ Unused 



DSAVE - Device processing flags. 
RD RERDDONE - A card has already been read. 
AF ABORTFLAG - A device dear has already been sent for 
this scries of aborted lOQs. 



G. 23.00 
13- 68 



I/O 



2608 Line Printer PIT (HP-IB Svoteno) 



Thtrt it ont DIT ptr physical dtvict. If a physical dtvict represents rare 
than ont logical dtvict, tht logical dtvict nunbtr it obtained fron the IOQ 
tltntnt (however, thtrt is only ont dtvict ptr 2608 controlltr. ) Tht 
following diagran shous tht DIT used for tht 2608 lint printer driver. 



20 



10 
11 

12 
13 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 MERONIC 
—I — I — I — I — I — I — I — I — I — I — I — I — I — I — i - 

0| OIACIRQI 0| 0| OIIOIIAINOISTI 0| STATE DFLAG 

-l-l-l-l-l-l-l-l-l-l-l-l 

SYSDB RELATIVE POINTER TO THE DIT IOUHK 

FOR THE NEXT DEVICE REQUESTING 

THIS RESOURCE OR SERVICE 



IOQ TRBLE RELATIVE INDEX TO THE FIRST IOQ 
IOQ IN THE REQUEST LIST FOR 
THIS DEVICE 



LOGICAL DEVICE KWBCT 



SYSDB RELATIVE POINTER TO THE 
DEVICE LINKAGE TABLE 



SYSDB RELATIVE POINTER TO Tht 
INTERRUPT LINKAGE TRBLE 

, JJJ , JPSIFLITP 



HARDUARE ERROR POINTER 

SET UHEN THE DRIVER DETECTS RN 
ERROR. UHENEVER <> 0, THE DRIVER 
ItONITOR LOGS RN I/O ERROR RNO 
CLEARS THIS UORD 



BIT IS SET RT CORPLETION Of TlttR 



HOLDS THE THE OUT REQUEST ENTRY INDEX 
UHILE A TWER IS ACTIVE 

IOT | ~f PHYSICAL UNIT • 
•I 1- 



KRRDUARE LOGGED ERROR STATUS 



DIOQP 

DLDEV 
DOLTP 

DILTP 

DSAVE 
DSERR 



I/O 



DFLAG - Flagt and request state: 
AC ACTIVE - A nonitor is currently servicing this dtvict. 
RQ REQUEST - A service request it sending while tht nonitor it 

activt. 
10 IOPROG - Rn I/O Channtl Progran it running For this device. 
IR IAX - An interrupt or response has occurred For thie device. 
NO NOTROY - Go to ttatt Z10 afttr Idle Channel Progran it started. 
ST STUflIT - Tht dtvict nonitor is starting an Idle Channtl Progran 

for this dtvict; thtrt it no IOQ attociattd uith thit 

typt of request. 

STATE - State of the device nonitor - specifies the newt action 
to be taken in SI00I1 in servicing the request: 
ZO - Start neu request. 

1 - Not used. 

2 - Call driver initiator procedure. 

3 - Call driver conpletor procedure. 

4 - Not used. 

5 - Process request eonpleted. 

6 - Initiate device recognition sequence. 

7 - Start operator intervention uait. 

10 - Uait for interrupt (operator intervention) 

restart at state 0. 

11 - Uait for data segnent freeze, then etate 2. 

12 - Uait for driver initiator to be frozen, then 

allocate controller (state 2). 

13 - Uait for I/O conpletion interrupt, then state 3. 

14 - Uait for controller, thtn call drivtr initiator. 

15 - Not ustd. 

16 - Uait for initiator nakt prtssnt, then state 2. 

17 - Uait for conpletor nake present, then etate 3. 

DUNIT - I/O systen type and unit nunbtr. 



IOT I/O TYPE 



DTIHE 
MOST 



DUNIT 
DLOGERROft 
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I/O Systen type: 

• Series II/III I/O systen 

1 « HP-IB Syetene 

2 ■ Unused 

3 " Unused 



DSAVE - Device processing flage: 

VH VFCHOD - VFC has been nodified. 

TAB TR60FRULT - Systen tab default. 

PS PRESFRCE - Last request used prespacing. 

FL FULL - Line printer buffer is full. 

TP TOP - Fnnter is at top of forn. 



^y 
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2608 Line Printer Status 



BYTE 1 & BYTE 2: 
BITS USE 



1 
2 
3 

4 
5 

6 

7 
8 

9 

10 
11 
12 

13 
14 
15 

BYTE 3: 

BYTE 4: 

BYTE 5: 



BYTE 6: 

BYTE 7: 

BYTE 8: 

BYTE 9: 

BYTE 10: 

BYTE 11: 

BYTE 12: 

BYTE 20: 



Not ready 

VFC channel 9 (botton of forn) 

VFC channel 12 (top of forn) 

VFC initialized 
6/8 lines per inch 
(not used) 

Pouer restored/unit reset 

On line 

Print nechanisn error 

Self test failure 
Paper error 
Self test node 

6/8 lines per inch 
Platen/ribbon error 
(not used) 

Print node 

BITS 0-7 Rode nunber 

Prirtary/secondary 

BITS 0-3 Secondary character set code 

BITS 4-7 Prinary character set code 

Self test 

BITS Pass/fail 

BITS 1-7 Subtest nunber 

6 LPI dot rou count 

6 LPI foro line nunber 

6 LPI forn length in lines 

8 LPI dot rou count 

8 LPI forn line nunber 

8 LPI forn length in lines 

Firnuare identification code 

Pouer-up language 

BITS 0-3 Secondary character set code 

BITS 4-7 Prinary character set code 



I/O 

HP 2619R or 2613 Una Prm ttr PIT (HP-IB Svstens) 

There is one OIT per physical device. If a physical device represents 
nort than one logical device, the logical device nunber is obtained 
fron the IOQ elenent (houever, there is only one device per HP 2631 
controller.) The following diagran shous the OIT used for the 
HP 2631 line printer driver. 
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OF LAG - Flags and request state: 
RC ACTIVE - fl nonitor is currently servicing this device. 
RQ REQUEST - R service request is pending uhile the nonitor it 

active. 
10 IOPROG - Rn I/O Channel Progran is running for this device. 
Ifl IRK - Rn interrupt or rteponse has occurred for this device. 
NO NOTRDY - Go to state Z10 after Idle Channel Progran is started. 
ST STURIT - The device nonitor is starting an Idle Channel Progran 

for this device; there is no IOQ associated uith this 

type of request. 

STRTE - State of the device nonitor - specifies the next action 
to be taken in SIODfl in servicing the request: 
ZO - Start neu request. 

1 - Not used. 

2 - Call driver initiator procedure. 

3 - Call driver conpletor procedure. 

4 - Not used. 

5 - Process request conpleted. 

6 - Initiate device recognition sequence. 

7 - Start operator intervention wait. 

1 - Uait for interrupt (operator intervention) 

restart at state 0. 

11 - Uait for data segnent freeze, then state 2 . 

12 - Uait for driver initiator to be frozen, then 

allocate controller (state 2). 

13 - Uait for I/O conpletion interrupt, then state 3. 

14 - Uait for controller, then call driver initiator. 

15 - Not used. 

16 - Uait for initiator nake present, then state 2. 

17 - Uait for conpletor nake present, then state 3. 

DUNIT - I/O systen type and unit nunber. 

IOT I/O 1YPE - I/O Systen type: 

• Series II/III I/O Systen 

1 * HP-IB Systens 

2 * Unused 

3 = Unused 

OSRVE - Oevice processing flags: 
BJ BETJOB - BetMeen jobs flag; if set, the Ponerfail 

nessage is suppressed. 
RB ABORT - Abort (caused by PoMr.'ail or Operator) 

has occurred. 
PS PRESPACE - Last request used pressing. 
FL FULL - Une printer buffer is full. 
TP TOP - Printer is at top of for*. 
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1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 UNEnONIC 

Z0| 0| OIACIRQI Ol 0| OlIOIIRINOjSTI 0| STATE 

SYSDB RELATIVE POINTER TO THE OIT 
FOR THE NEXT OEVICE REQUESTING 
THIS RESOURCE OR SERVICE 



11 

I 

I 

I- 
21 



IOQ TABLE RELATIVE INDEX TO THE FIRST 
IOQ IN THE REQUEST LIST FOR 
THIS OEVICE 



I I- 



LOGICAL DEVICE NUnBER 



SYSOB RELATIVE POINTER TO THE 
DEVICE LINKAGE TABLE 



IOFLAG 
-I 

I DUNK 

I 

I 
-I 

IDIOQP 

I 

I 
-I 

IDLDEV 
-I 

IDDLTP 

I 
-I 

IDILTP 

I 
-I 



61 

I- 
71 



I 
101 

I 
111 

I 



SYSOB RELATIVE POINTER TO THE 
INTERRUPT LINKAGE TABLE 
1 -. | - 1 - 1 - 1 - 

I BJ I RB I PS I F LI TP I OSRVE 
1 - 1 - 1 - 1 - 1 - 1 

HRRDUARE ERROR STRTUS IDSERR 

SET UKEN THE DRIVER DETECTS RN 
ERROR. UHENEVER <> 0, THE DRIVER 
HONITOR LOGS RN I/O ERROR RND 
CLEARS THIS UORO 



BIT IS SET RT CQI1PLETI0N OF TWER 



I- 



HOLOS THE TIHE OUT REQUEST ENTRY INDEX 
UHILE A TlflER IS RCTIVE 

12 j IOT | I PHYSICAL UNIT « 
| 1 1 

131 KRRDURRE LOGGED ERROR STRTUS 



DTIHE 
DRQST 



DUNIT 
DLOGERROR 
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HP 2680R/2688R OIT 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I — I — I — I — I — I — 1 — I — I — I — I — I — 1 — I — I — ■ — I 

OIT 010 10 IRCIRQIO |0 |SP|CP|IR|NR|SU| I STATE IDFLRG 
-|~|--|--!--|~l~l~l~|--M~l I 

POINTER TO NEXT OIT I DUNK 



1 
2 
3 
4 
5 
6 
7 

10 
11 
12 
13 
14 
15 



INDEX TO RCTIVE IOQ OR ZERO 



LOGICAL DEVICE NURBER 



DRIVER LINKAGE TABLE POINTER 
INTERRUPT LINKAGE TABLE POINTER 



SPECIAL ERROR CONDITIONS TO BE LOGGED 



ERROR LOGGING INFORRRTION 



T | TinEOUT INDICATION IN BIT 
TWER REQUEST INDEX (TRL) OR ZERO 



IOT | 



-I— 



CIOQP 
DLDEV 
DDLTP 
DILTP 
ICSTRT 

DSERR 
-I 

IDTWE 
-I 

IDTRLX 
-I 



PHYSICAL UNIT « | DUNIT 



CURRENT DATA URITE BYTE COUNT 



I- 



CURRENT DATA UQRD COUNT 
M OF UOROS LEFT TO TRRNSFER 



-I 

IOCBCNT 
-I 

IDCUCNT 
-I 

IDRCNT 
-I 



161 BUFFER OFFSET FOR NEXT « OF UOROS TO XFER IDOFFSET 
, 1-| 

17| I DIDDEBUG 

! 1-| 

201 I/O STATUS BLOCK UORO 1 GETS IDLOGBuTFER 

| LOGGED FR0I1 HERE I 

, 1 

21 | I/O STRTUS BLOCK UORO 3 GETS I 

I LOGGEO FRQn HERE I 

| 1 

221 I/O STRTUS RRER IDIOSTRT 

I (16 UORDS, SEE DEFINITION) I 



OF LAG « 



Device relative flags: 

RC - Active bit • 1 inplies that a nonitor is currently 

servicing this device. 
RQ - Request bit • 1 inplies service requested uhile the 

nonitor is active. 
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SP - SIO preenptien - if Ht, thin a prttnptivi requett 

hat btcn queued for this dtvict; the preenpt codi it 

ttt in tht IOQ tltnent. 
CP - Channel progran in progrttt - if ttt, thtn a channtl 

progran it currently txtcuting. 
IA - If ttt, an interrupt or rttpontt hat occurred. 
NR - If ttt, tht dtvict it in a not ready or optrator uait 

ttatt. 
SU - If ttt, an idlt channtl progran should bt ttarttd for 

thit dtvict. 
flSTATE - Current dnvtr ttatt at dtfintd by tht nonitor; allouablt 
stattt are: 

ZO - Start requett. 

1 - Not uttd (restrvtd). 

2 - Call drivtr initiator. 

3 - Call dnvtr conplttor. 

4 - Unuttd (restrvtd). 

5 - Conplttt requttt (ptrhapt return to uttr). 

6 - Untxptcttd inttrrvpt occurred. 

7 - Start optrator inttrvtntion uait. 

10 - Uaiting (on optrator) - rettart at 0. 

11 - Uaiting (data naktprettnt/fretzt). 

12 - Uaiting (initiator codt naktprettnt/fretzt). 

13 - Uaiting (for conplttion mttrrupt). 

14 - Uaiting (for dtvict controlltr availability). 

15 - Unuttd (restrvtd). 

16 - Uaiting (initiator codt naktprestnt). 

17 - Uaiting (conplttor codt naktpretent). 

DUNIT - I/O tytten typt and unit nunbtr. 
IOT - I/O tysttn typt: 

- HP 3000 Stritt II/III (SIO/DIO) 

1 - HP-IB Sytttnt 

2 - Rtttrvtd 

3 - Rtttrvtd 

DCBCNT - Current bytt count to bt trantftrred. 

OCUCNT - Current uord count to bt trantftrred. 

ORCNT - Rtnaining uord count to bt trantftrred. 

DOFFSET - Off ttt in bufftr of ntxt nunbtr of uordt to trantftr. 

DDEBUG - If bit 15 * 1 thtn dtbugging information uill bt ttnt 
to tht consolt. 

DLOCBUFFER - Status uords 1 & 3 are novtd here to bt loggtd - if 
thty uere logged fron the I/O status block their 
contents night bt changed before they utre loggtd. 

OIOSTRT - I/O ttatut area (16 uords) - set I/O ttatua block 
dtfinition. 



G. 23.00 
13- 75 



IHP Oevice Infomation Table (PIT) (Cont.) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 IS 

261 PARAHETER 2 (0r?R2) I00UTP2 

27| SENS DIALOG COUNTER IDSENO 

301 RECEIVE DIALOG COUNTER IDRECV 

I I 

31 1 "nESSRGE SENT" EOT BUFFER IOEOT 

I- I 1 

321 RESERVED I flESSAGE FROfl 1NP TYPE IDIM1SG 

i ; - i 

331 REQUEST IDENTIFIER (IOC X) IDINID 

| |..| |..| — 

ERROR CODE - |UT| |CN| STRTUS IDRSTRTUS 

I~l l-l— 

IN COUNT 



34 
35 
36 
37 
40 
41 
42 
43 
44 
45 
46 
47 
50 



TRANSMSSION LOG 

PRRRflETER 

TRRCE RERDY REQUESTS COUNT 



DINCNT 

DXLOG 

DINPRRfl 

DTRCNT 

DDSTN 



EXTERNAL TRACE EXTRP. DRTR SEWENT NUnBER 

RESERVED I PUT "TG TiPE RT ERROR DERROR 
1 

REQUEST IDENTIFIER (IOQX) 



PRRArtETER 1 (QfllSC) 



OUT COUNT 
PRRRRETER 2 (QPRR2) 



LUST CS ERROR CODE 



DCSERR 

DSRVE 

DVERSION 



IOQP POINTER RT TIRE OF ERROR 
51JTP|PHV DRVR VERSN R |H | LOGICRL DRVR VERSN • 

S2| RESERVED*"" I IN HSG TYPE RT ER*OR IDERR0R1 

53 | REQUEST IDENTIFIER (IOQX) I 

54|"""eRR0r"c0DE |UTj |CNj STATUS \ 



| 

55 | IN COUNT 
I 



-l-l l-l 



G. 23.00 
13- 77 



I/O 



I/O 



JWP Dtvict Infoma tion Table (PIT) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

MH -|~|--|--|"|-I"I-I-I"I"I"I-I"I 

DITOI IRCIRQITII OIPRIIOlINlSninAnSTATEl IOSTATEIDFLAG 

1| POINTER TO NEXT DIT I DUNK 

| 1 

21 INPUT REQUEST QUEUE IDIOQX 

| 1 

31 LOGICRL DEVICE NUftBER IDLDEV 

| 1 

41 DRIVER LINKAGE TABLE POINTER IDDLTP 

j 1 

51 INTERRUPT UNKRGE TABLE POINTER IOILTP 

| 1 

61 INTERRUPT STATUS IDSTATUS 

| 1 

7| SOFTUARE TIBER REQUEST INDEX IDTRLX 

| - 1 - 1 1 

10|SU|HU| HRRDURRE TWER REQUEST INDEX (33) IDTME 

,..,.., J 

111 RESERVED I 

, j 

121 RESERVED I 

| 1 

131 RERDY QUEUE HERD POINTER IREROVQ 

, j 

14| READY QUEUE TAIL POINTER I 

| 1 

151 ACTIVE QUEUE HERD POINTER IRCTIVEQ 

| 1 

161 ACTIVE QUEUE TAIL POINTER I 

| 1 

17| URITED QUEUE HERD POINTER IUAITEDQ 

201 UAITED QUEUE TAIL POINTER I 

l-l-l-l l-l-l-l-l 1 l-l 

21|E0|UP|TR| PFSTRTE |UF|PR|NR|SD| OS I IRBIDSTRTE 
l-l-l-l l-l-l-l-l 1 l-l 

22 1 RESERVED I HESSRGE TO INP TYPE IDOUTNSG 
, 1 1 

23 1 REQUEST IDENTIFIER (IOQX) IDOUTID 

24 1 PARRHETER 1 (QMSC) ID0UTP1 

25 1 OUT COUNT JDOUTCNT 
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56 

57 

60 

61 



62 HRRDURRE ERROR STRTUS | SIO PROGRAH INDEX 



63 
64 
65 

66 
67 
70 
71 



INP Dtvict Infomation Table (DIT) (Cont.) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
— I — I — ■ — I — I — I — I — 1 — 1 — I — I — I — I — I — ■ — 1 

TRANSMSSION LOG I 



PARAMETER 



DRIVER ERROR CODE 



RONITOR ERROR CODE 



-I- 



I DDRVRERR 
DftNTRERR 



-I- 



TOOTKPICK HRRDURRE ERROR STATUS 



DRIVER TRRCE RERD IOQ INDEX 



RESERVED 



DSTN FOR PORT TRRNSLRTOR 



PLflBEL FOR PORT TRRNSLRTOR 
INP CONTROLLER DIT SIZE 



DTP 'ERROR 

DTR'IOQX 

OTRRNDSTN 
DTRRNPLBL 
DITSI2E 



INP DIT Fitld Otf initiont: 

DFLAG • Flags, IOSTATE and RRflSTATE. 

.ACTIVE - If ttt, tht Orivtr it aetivt strvieing thit dtvict. 

.REQUEST - If ttt, tervice for thit dtvict Mt requttttd uhilt tht 
Drivtr uat tctivt. Tht Drivtr it run again to inturt 
servicing of tht condition uhich caused REQUEST to bt ttt. 

.DO'TiniNG • If ttt, tht harduare and toftuare tintrt trt ttarttd in 

tht nornal ntnntr when perfonung an operation. If dtar, 
no tming it dont. 

.SIOPREERPT- Pretnptivt requttt qututd by ATTRCHIO. Not uttd by thit 
Drivtr. 

.IQPROG - If ttt, an I/O progran it in progrttt. Stt by STARTIO and 
cleared by GIP. Not uttd by tht Orivtr. 

.IRK • Inttrrupt Rckneultdgt. If ttt, an inttrrupt hat occurred or 
a toftuare tintout hat conpltttd. 



G.23.00 
13- 78 



I/O 
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. SinuUtTQR - If set, all I/O it to be einulated. The Orivtr uill eet 
flags in thi ORT instead of calling STARTIO. 

.nAHSTATE - nenory nanager Statt. 

- Hull, no nenory Hanagenent requests or condition. 

1 - Not ustd. 

2 - Data segnent associated uith the first request in the 

Active Queue is being nade present and frozen. 

3 - Data segnent associated uith the first request in the 

Active Queue is frozen in nenory. 

4 - Data segnent associated uith the second request in 

the Active Queue is being nade present and frozen. 
Inplies the data segnent associated uith the first 
request is frozen. 

5 - Data segnents associated uith the first and second 

requests on the Rctive Queue *rt frozen in nenory. 

6 - Not used. 

7 - Not used. 

.IOSTATE - Current I/O progran operation being performed. 

- Inactive. No I/O in progress. 

1 - Idle Read. The Idle Read I/O progran has been started. 

2 - Sending nessage. An I/O progran uhich sends a nessage 

uithout data and then goes to the Idle Read section 
of the I/O progran has been started. 

3 - Sending data. An I/O progran uhich sends a nessage 

and data and then goes to the Idle Read section has 
been started. 

4 - Send nessage and interrupt, fln I/O progran uhich 

sends a nessage uithout data then interrupts and 
halts uhen the nessage sent has been started. 

5 - Send data and interrupt. Rn I/O progran uhich sends a 

nessage uith data then interrupts and halts has been 
started. 

6 - Receive data. Rn I/O progran uhich sends a nessage 

and receives data then interrupts and halts has been 
•tarted. 

7 - Do not start I/O. Used to hold off requesting any I/O 

activity during a pcuer on reset or uhen an error 
occurs. 

DUNK - Link uord for the linked list of devices uaiting to be eerved 
by the I/O process associated uith this device. 

DIOQP - Systen DB relative pointer to the first elenent in the request 
to be processed list for this deviee. The requests are queued 
to thie list by ATTACHIO but in processing, they are noved 
to other queues depending of the state of the request, 
the Driver aluays attenpts to keep this list enpty. 

DLDEV - Logical Device Nunber of this device. 

DDLTP - Systen DB relative pointer to the Driver Linkage Table (DLT) 
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2 - Pouer failure detected on the flainfrane before IMP 

has indicated a pouer failure. Uait for IKP to 
indicate a power failure. 

3 - Pouer failure indicated by INP before being inforned 

by the flainfrane pouer failure routine*. Uait for the 
flainf rane pouer failed request. 

4 - Pouer failure indicated both en the flainfrane and by 

INP. Pouer failure recovery nay be etarted. 

5 - Send Redo. The Hainf rane receive count uas lees than 

the INP send count so the dialog nuet be reetarted. 
The Driver it eending the Redo nessage. 

6 - Send Ignore. The flainfrane eend count u*9 greater than 

the INP receive count eo any part of a dialog eo far 
received is to be ignored and the entire dialog uill 
be retransnitted. The Driver le eending Ignore nessage 

7 - Recovered. The flainfrane and INP dialog counters 

agree or flainfrane not eending, so no recovery ie 
necessary. The Driver is sending the recovered 
nessage inforning INP to go back to its nomal node. 

.UNFRZ - If set, the source data segnent ie to be unfrozen uhen 
the data has been tranenittcd to the INP. If dear, 
the source data segnent renaine frozen until a request 
conplete indication ie returned by the INP. 

.PASSRERDS - If set, then read requests are to be passed around other 

requests uhich have been inpeded because no buffers are 
available on the INP. 

.NOTRD v UAIT- If set, then a requeet has been inpeded because no buffer* 
uere available on the INP. 

.SENDING - If set, an I/O progran uhich sends a nessage, uith 
or uithout associated data, has been etarted but not 
conpleted. 

.GPEmSTATE - Operational state of the Driver and INP. 

- Not opened or cloeed. 

1 - In ROH. The device has been opened but the RAH 

Operating Systen has not been entered. 

2 - Crashed. Sone catastrophic error has occurred. 

3 - In RAH. The device has been opened, down loaded, and 

is in the RAn Operating Systen. 

.ABORT - If set, one or nore requests have been aborted but the 

abort uas not done becauee the aborted request uae in the 
process of doing a nenory flanagenent function or I/O uhen 
request to abort uas proceeeed. The actual abort uill 
take place uhen the flenory flanagenent function conpletee. 

*?;;7n$G - nessage type code for nessages sent to INP. 

C0UT1D - Request identifier associated uith the nessage being sent. 
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DILTP - Systen DB relative pointer to the Interrupt Linkage Table (ILT) 

DSTATUS - Controller harduare status. Set by GIP on interrupt and the 
Physical Driver during certain service operations. See INP 
ERS for description. For the Toothpick version, this uord 
contains the softuare tmeout flags as described for the uord 
DTWE belou. 

DTRLX - Tiner request index for softuare tineouts as returned by the 
HPE procedure TWEREQ. 

DTME - Tined out flags and type 3 driver process PCB Nunber. 

. TZdCD - If set, a softuare tineout has conpleted. 

READYO - Systen DB relative pointer to the IOQ for the first request 
the Ready Queue. If zero, the Ready Queue is enpty. 

RERDYQTL - Systen DB relative pointer to the last IOQ in the Ready 
Queue. Uhen the queue is enpty, this uord points to the 
uord preceding then queue head pointer in the DIT. 

ACTIVEQ - Systen DB relative pointer to the IOQ for the first request 
the Active Queue. If zero, the Active Queue is enpty. 

ACTIVEQTL - Systen DB relative pointer to the last IOQ in the Active 
Queue. Uhen the queue is enpty, this uord points to the 
uord preceding then queue head pointer in the DIT. 

UAITEDQ - Systen DB relative pointer to the IOQ for the firet request 
the Uaited Queue. If zero, the Uaited Queue ie enpty. 

UAITEDQTL - Syeten DB relative pointer to the last IOQ in the Uaited 
Queue. Uhen the queue is enpty, thie uord points to the 
uord preceding then queue head pointer in the DIT. 

DSTATE • Driver etate and control flags. 

.ERRORONLY - If set, the Driver trace record ie to be returned to the 
Trace Process only uhen an error occurs. 

.URAP - If eet, the Driver uill overlay the oldest trace entry 

uhen a trace record overflou occurs. If dear, entries are 
lost uhen an overflou occur*. 

.TRRCEON - If set, the Driver trace facility is enabled and the Driver 
generates trace entries for nost of its local subroutine 
calls. 

.PFSTATE - Pouer failure recovery etate. 

- No pouer failure recovery in progress. 

1 - Pouerf ailure detected on the flainfrane before INP 

indication. Check for conpletion of any pending I/O 
and then uait in PFSTATE 2 for INP to PFAIL. 
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D0UTP1 
DOUTCNT 
D0UTP2 
DSENO 

DREW 

DEOT 



DINnSG 
OINID 
DRSTRTUS 
DINCNT 

DXLOG 

DINPARn 

OTRCNT 

DDSTN 

DERROR 



> Paraneter one of the nessage being eent to INP. 

• Count paraneter of the neesage being eent to INP. 

• Paraneter tuo of the neeeage being sent to INP. 

• ftessagee sent counter. This uord contains the nunber of 
nessages eent since the RAH Operating Systen uas entered. 
It is used for pouer failure recovery. 

• fleesagee received counter. This uord contains the nunber of 
nessages received fron INP since the RRn Operating Systen uae 
entered. It ie used for pouer failure recovery. 



End of dialog flag. 
EOT indicating INP h 



Uhen a neeeage has been sent and the 
' has received the nessage is transmtted, 

is received into this uord. This flag is used to indicate 
the Logical Driver that a traneniesion has been conpleted 
and the Physical Driver should be called to check the 
conpletion status and update the IOSTATE. 

• Ressage type code of nessage fron INP. 

• Request Identifier associated uith nessage fron INP. 

- Requeet Conpletion status. 

- Nunber of bytes of data to be received associated uith the 
conpletion of a request uhich results in data being sent 
fron INP. 

- Transnission log to be returned uhen the request identified 
by OINID is conpleted. 

- rarenete- associated uith the conpletion of this request. 
This -ord is returned in the X register by IOSTATUSX. 

- Trace ready pending count. This uord contains the nunber of 
Trace Ready nessages received but not satisfied by Trace Ready 
requests. 

• If not zero, then internal Driver extra data segnent tracing 
is enabled and this is the d?ta segnent number into uhich the 
trace entries are to be set. 

- Driver Error block. The f&Ueuing sixteen uords are used to 
etore infomation describing the current operatione being 
perf'.r*<ed u*en a catastrophic Cr*ver error occurred. A 
catastrophic error crcurs on illccjcal Driver control data, 
nPE errors, or uhen inP does not respond in an ejected nanner. 
The first five-uord block is used ts h-ld the current 

or last nessage transmtted to INP uh»n a catastrophic error 
cor.citicc uas detected. It contains the data in the sane forn 
as nessije to IMP block. 
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DCSERR - CS Error Codt associated uith a catastrophic Drivtr trror. 

OSRVE - Request Identifier of tht requcet being proceessd uhsn a 
catastrophic Driver trror uat detected. 

DVERSION - Vereion nunbere of the Physical and Logical Drivers. 

.Tp .jf $tt, the Physical Onver is for the Toothpick Systen. 

.PVERSION - Physical Driver version nunber. 

.LVERSIOH - Logical Driver version nunber. 

DERR0R1 - The eix-uord block beginning here is used to hold the last 
nessage received fron INP before a catastrophic Driver error 
uas detected. It contains the data in the sane fornat as the 
nessage fron INP block. 

DDRVRERR - Holds the code specifying the catastrophic error detected 

by the Physical Driver. See ERRORS under the PHYSICAL DRIVER 
INTERNAL SPECIFICATIONS for the definition. 

DMNTRERR - Holds the code specifying the catastrophic error detected 
by the Logical Driver. See ERRORS under the LOGICAL DRIVER 
INTERNAL SPECIFICATIONS for the definition. 



DSERR 

.HSTRTUS 
.SIOPX 

DTP' ERROR 
DTR'IOOM 

DTRANDSTN 
DTRRNPLBL 
DITSIZE 



- Hardware Controller status when a catastrophic Driver error 
uas detected. 

- Left byte of the DSTATUS uord at tine of error. 

- SIO progran trti relative index to the last order executed 
or current order being executed at tine of error. 

- Toothpick hardware error statue. To be defined. 

- If not zero, then an IOOP pointer to the Trace Read request 
uhich is supplying the locked and frozen buffer into uhich 
the Driver places trace entries to generate a trace record. 

- DSTN for port translator. 

- PLA8EL for the port translator. 

- INP controller DIT size. 



I /0 



I/O Status Block 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 OIT 

0|0 | THE "OR" OF UORDS 1/15 IS LOCATED HERE |Z21 
l-l-l-l-l-l 1 

1|0F|nS|PH|PE|TE| «2 

2|"" " RESERVED 1*23 



I- 



— I 



>^% 



3| HCS FAULT NUI18ER IZ24 

_|--I~MHH--M-I--I--M-I--I--I--I 
4|CL|FL|VL|CU|FU|VU|ILlIP|ST|SB|IR|nP|NJ|Nn|TL|NC!Z25 



5 

6 
7 

10 
11 
12 
13 
14 
15 
16 
17 



-I — I — I — I — I — I- 

LP|PF|NC| 



-l-l-l-l- 



RESERVED 



-l-l-l-l 



RESERVED 



RESERVED 



RESERVED 



RESERVED 



|Z26 
-I 

IZ27 
-I 

|Z30 
-I 

1231 
-I 

IZ32 
-I 

IZ33 



RESERVED 

RESERVED IZ34 



IZ35 
-I 
IZ36 



RECORD NUMBER OF ERROR 
IF UORD 4 IS 
NON-ZERO 



-I 



SHEET NUHBER OF ERROR IF UORD 4 IS |Z37 
NON-ZERO OR LAST SHEET TRANSFERRED -I 
IF "JOB" RNO POUER ARE ON |Z40 



-I 
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UORD 2 - Reserved (unused). 



I/O 



UORD 3 



UORD 4 



- hXS fault nunber - contains an integer describing tht 
last fault to occur since the last tine tht I/O etatut 
uae read or the HP 2680R/2688A uas powered down; if tht 
uord is zero there is no HCS fault (see DCS ERS for a 
description of the DCS fault rambsrt). 

- bit • - (CL) no roon for attenpted character set load. 

1 - (FL) no roon for attenpted font load. 

2 - (VI) no roon for attenpted VFC load. 

3 • (CU) attenpt to print data and then it no 

currently eelected character set. 

4 • (FU) attenpt to select an undefined fom eet. 

5 - (VU) attenpt to print data and there it no 

currently selected VFC eet. 

6 - (XL) attenpt to print data and there is no 

currently selected logical page table (LPT) 
entry. 

7 - (IP) attenpt to novo pen off the logical page. 

8 - (ST) the 2680A/2688A could not process all of 

the data before it uae supposed to be 
transferred to the drun/paper - data uae loot. 

9 - (SB) spooler block contains fornat error. 
10 - (IR) invalid recovery block received fron 

the spooler. 

(IIP) naxinun nunber of copies par physical page 
has been exceeded - thie ie a result of tht 
spooler process setting the naxinun copies per 



11 



page uith function code 132. 

• 00) * * ~ 



12 - (kj) a connand or function code uae received 
when no "JOB" uas in progrees - the connand or 
function uas ignored by the DCS. 

13 - (Nfl) no nenory - 2680A/2688A dynanic nenory 

allocation hae detected that nain nenory it 
eonpletely occupied uith character eets, VFCt, 
forns and data such that the 2680A/2688A cannot 
process the current input data - data uill be loot. 

14 - (TL) attenpt to print data and there ere nore than 

the naxinun allouable Logical Page Table (LPT) 
entries selected. 

15 - (NC) a non-existent VFC channel uas skipped to. 

UORD 5 - BIT « - (LP) logical page truncated to fit phyeical page. 

1 - (PF) page sire required by progranner did not 

natch page size eet by operator - operator page 
size prevails. 

2 - (NC) no character set eelected. 

UORD 6/13 - Reserved for future use (unused). 



UORD - Each bit is the 'OR' of one uord in the table (except 
bit uhich is not used); bit .(1:1) is set if uord 1 
in the table is non-zero. 

UORD 1 - bit ■ - (OF) online/offline bit. 

1 - (US) nessage being displayed on the 2680A/2688A 

console. 

2 - (PU) pouer up conpleted since laet I/O etatut 

read. 

3 - (PE) parity error detected on PHI connand. 

4 - (TE) transnission error detected in the printer. 
5/15 - Reeerved (unused). 
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I/O 

UORD 14/15 - Tht record mmbtr uhich contains the offending error 

at dtfined by word four - if a pouer fail occure during 
a "JOB", the pouer fail bit ie set and a sheet nunber is 
nade available in words fourteen and fifteen; houtvtr, 
tht record nunbtr ie lost and cannot be reported (these 
words occur in a "JOB" only). 

UORD 16/17 - Tht sheet nunbtr on uhich tht trror occurred as defined 
by uord four - if an error occurs in the environncnt file 
at the otart of a "JOB", then this nunber uill be zero; 
additionally, uhtn a pouer fail occurs during a "JOB", 
the power on bit is set in uord one and the eheet 
nunber of the laet eueceeefully traneferred page it 
placid here (this infomation is for use by the 
tpooltr should a recovery of a "JOB" be detemined - 
theee uords occur in a "JOB" only). 

Rll uords of the I/O Statue ere cleared uhenever the etatus block 
it returned to the hoet. It ie up to the hoot CPU to retain any 
ongoing etatue bite required. 

WISC - Hiacelleneous request dependent etorage available to driver. 

| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I0Q3|nB|RB|RB|I0|T0| I XFER I PARITY IQnlSC 
I M-M-l-l-M-M I l-l 

.(0:1) - (MS) user requeeted a tranefer in excise of 4096uords; 

the driver can write up to 4096 uorde to the 2680A/2688A. 
In order to handle up to 32X uorde, nultiple untes »rt 
ueed uithout a return to the user uho called the driver. 
Thie bit indicatee that nultiple uritee are being done 
to the 2680A/2688R. 

.(1:1) • (Rfl) the current uritt bloek nuet be retried. 

.(2:1) - (AB) ueer requeeted abort in progrees flag. 

.(3:1) - (10) I/O status has been read and is available. 

.(4:1) - (TO) general I/O controller tints out. 

.(5:4) - Reeerved (unused). 

.(9:3) - (XFER) 2680A/2688A transfer error counter. 

.(12:3) - (PARITY) channel progran connand parity error counter. 

.(15:1) - Reserved (unused). 

**NOTE**In the above exanple, single bit fields are as defined 
uhen the bit ie a logical "1". 
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D^e Request Tablt and D itc Requests 



Requests for disc transfers are effected by acquiring an entry fron the Disc 
Request Table (DISCREQTRB), filling the proper infomation, and calling the 
DISCQUANAGER to link the request into the device's doubly linked request 
queue. 

The head and tail of * device's request queue tn contained in the 
devices' OIT. 



DISCREQTRB 



r 




i /o 



Disc Request Table 



| DISCREQTRB DST « 56 (Z70) 

DISCREQTRB PRT * Z1017 



Disc Reoueat Table En try Fornat 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I--I--I--I--M--IH--I--M--I--I--I--I--M 
DISCREQTRBOOI TOTRL ENTRIES 

| 1 

DISCREQTRB01 I ENTRY SIZE (Z21) I 

| 

DISCREQTRB02I PRMfiRY ENTRIES 

| 1 

DISCREQTRB03I WPEDED PROCESS PCB I 

DISCREQTRB04I TABLE INDEX OF HERD Of AVAILABLE 
I ENTRY LIST 

DISCREQTAB05I TABLE INDEX OF TAIL OF AVAILABLE 
| ENTRY UST 

DISCREQTRB06I flAX ENTRIES IN USE 

| 

DISCREQTRB07I CURRENT ENTRIES IN USE 

| 

I DISCREQTRB10I OVERFLOW 

| DISCREQTAB11I 

| TOTAL REQUESTS 
| DISCREQTAB12I 

| DISCREQTRB! 3 1 SYSBRSE INDEX OF HERD OF DISABLED REQ Q 



| DISCREQTR814I SYSBRSE INDEX OF TAIL OF DISABLED REQ Q 



I DISCREQTAB15I SERIAL URITE QUEUE HEAD 

I DISCREQTAB16IRI I HAX. SERIAL URITE QUEUE 

I DISCREQTAB17I 

| DISCREQTRB20I 

, 



DISCQMEAD 
DISCQTRIL 
SERUQHEAD 
A « Active 
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Disc Request Elowont Fornat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

l-IH-l-l-l-l-MH-l-M-l-M-l 
Uord OOlfl |n |D IS II IB |C |D 111 IQ IS IP |C ID |L II 
IB in |I |B 10 |K |0 |A |n |U II IF |U II ID IN 
|0 |R |A |U |U ID |H |T IE IE 10 |A |R IS |R |L 
IR IE |G |F |A | IP |A |R |U IF |I |R |A I |0 
IT |Q | | IK | | IF |R IE |A |L IE IB I |C 
I I I I IE I I I I I IX | |Q I I m 
I I I I I I I I I I HI I I IL 



Uord 01 
Uord 02 
Uord 03 
Uord 04 

Uord 05 

Uord 06 

Uord 07 

Uord 10 

Uord 11 

Uord 12 

-I— 
Uord 13 FR| 



REQUEST URGENCY CLASS 



LOGICAL DEVICE NUHBER 



niSCELLANEOUS 



OST (IF PROCESS DISC I/O) 
BANK (IF SEGnENT TRRNSFER) 



OFFSET INTO DATA SEG (IF PROCESS DISC I/O) 
ADDRESS IN BANK (IF SEGnENT TRANSfER) 



UNIT » 



FUNCTION 



URGCLASS 
LDEVN 

msc 

DSTN 

S * Stack 
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- QFLAG 
Bit 
Bit 1 
Bit 2 
Bit 3 



Bit 4 
Bit 5 



COUNT/XLOG/CONTROL RETURNS 



P1 (KOOR IF SEGnENT TRANSFER) 



P2 (LODR IF SEGnENT TRANSFER) 



RDDR 

FUNC 
XFERCNT 
PRR1 
PRR2 



-I- 



PCB KUnBER 



QUALIFIER 



| STATUS STAT 
•I- 



INOEX OF PREV REQUEST IN QUEUE 



INDEX OF NEXT REQUEST IN QUEUE 



Uord 14 

Uord IS I 

Uord 16 

Uord 17| 

Uord 20|~ DISPLACEnENT OF REAO OR URITE 
| FROU SEG BASE (nil) 



• SEGIDENTIFIER (IF SEG TRRNSFER) 



PCBN 

PREVREQP 

NEXTREQP 

SEGIOENT 

SEGOISP 



• Request dependent flags. 

.ABORT Request has been aborted externally. 

.fWREQ Request is for a sequent transfer. 

.DIAG Diagnostic request (not used). 

.S6UF Systen Buffer. Target is a systen buffer 

uhose index is relativt to the start of 

the SBUF table. 
.IOUAKE Uake caller on completion of request. 
.BLOCKED Blocked I/O. Caller is waited in ATTACHIO 

until request is conpleted. 
Bit 6 .COnPLETED Request has been conpleted and caller auoken 

if he had specified. 
Bit 7 .DATAFRZN Data segntnt has been nadt prtsent and it 

frozen. 
.nRHERRORD nRH error on data segnent nake present. 
.PREQQUEUED Request is queued into disc's requtst 

queue. 
.SFAIL Start SIO failurt in GIP. 
.PFAIL The I/O has been aborted because of a 

pouerfail. 
.CURREQ Request is device's current request. 
.DISABLED Request is disabled. 
.LDR Request in logical DRQ. 
.INLOCAL Buffer DST is in process locality. 



Bit 8 

Bit 9 

Bit 10 
Bit 11 

Bit 12 
Bit 13 
Bit 14 
Bit 15 



Uord 2 - QLDEV.QLDEVN - Logical Device Kunbar. 

Uord 3 - QniSC - Device dependant. 

Uord 4 - QDSTN - If SYSBUFRs is clear then this is the DST nunbtr 
of the target data segnent. If bit is set then buffer 
address is a DB offset value instead of segnent relative 
offset (inplenented for NOUAIT 10 and NOW). 

Uord 5 - QADDR - Offset in data segnent or sys buff table to target 
data buffer. 

Uord 6 - QFUNC.FUNC - Function code and qualifiers as specified by 

driver. 



Note: Upon return to fret list, uord («1) btcones index of next EE free 
entry. 
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Uord 7 - QXFERCNT - On initiation tptcif iet tht uord count if potitivt 
or tht byte count if negative, fit conpletion of the rtquttt 
this location contains tht actual transnusion count in tht 
tant units as tht original call. Ctrtain control rtquttt* 
rtturn data through this location. 

Uord 10 - 8PRR1 - Parantttr ont, dtfintd by drivtr. 

Uord 11 - QPRR2 - Parantttr two, dtfintd by drivtr. 

Uord 12 - 

QSTRT. QUALIFIER * R codt uhich furthtr dtfits or qualifies tht 
gtntral status. Dtfintd by tht drivtr. 
QSTRT. STATUS - Gtntral status. Indicatts current and rtsult 
statt of tht rtquttt according to tht follouing 
codts: 

- Not starttd or waiting eonplttion. 

1 - Succtssful conpittion. 

2 - End of flit detected. 

3 - Unusual condition. 

4 - Irrtcovtrablt trror. 

Uord 13 - QPCBN.PCBN - PCB Nunbtr of proctss which nadt this rtquttt 
Ztro if not associattd uith any proctss and 
IOQ is to bt returned by tht systtn. 

Uord 13 - bit 0*1 - Q tlentnt is on free litt. 

NOTE: See I/O Systen Status Returns later in this chapter. 
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I/O Qutut (1001 Table Layout 



I- 
01 

I- 
11 

I- 
21 



TOTAL N 



ENTRY SIZE 



PRMARY « 



IHPEDED PROCESS PCB 



/- «l 



HERD INOEX 



TAIL INOEX 



HAXinUH OF IN USE 



CURRENT IN USE 



10| 

I- 
111 



121 

I- 
131 



OVERFLOUS 



TOTAL REQUESTS 



UNUSEO 



I 
-I 

I 
-I 

ITHERO 
-I 

ITTAIL 
-I 

ITUSE 
-I 

I 

ITOVRFL 
-I 

I 

ITRQSTS 

I 
-I 



/->! 



\~ 



INDEX OF 5 



ENTRY 1 



I I 

I I 

I I 

I I 

I I 

-I I 

|<~ | \ 

-I I I 



I 
1 



ENTRY 2 



INDEX OF 1 



I I 

I I 

I I I 

I I I 

I I I 

I I I 

! ! i 

I I 

I I 

I I I 

-I I I 
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I/O Qutut (100) Tablt Layout (Cont.) 



ENTRY 3 



INDETERMNRTE 



ENTRY 4 
(IN USE) 



INDEX OF 2 



ENTRY 5 



<— / 



I/O 



6 

7 

I 10 

I 111 



I/O Qutut Elenent (IOQ) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
..,.., — | — | — l — | — | — | — | — | — | — | — | — | — I 

REQUEST DEPENDENT FUGS 



IOQ POINTER 



OLDEVN 



MSCELLANtOUS 
S | DATA SEGT.ENT DST NUnBER 



ADDRESS 
UNIT N 



FUNCTION 



COUNT /XLOG/COHTROL RETURNS 
P1 



| QUALIFIER 
1 



I STRTUS 
-I 



QFUfc 
QUKK 
QLDEV 
QMSC 
QDSTN 
QRDOR 
QFUNC 
QUBCT 
QPRR1 
QPRR2 
QSTRT 
QPCBN 



P2 

I 121 

l-l 

| 13|FR| PCBN 

l-l 

QFLfiG - Request dependent flags: 

Bit .fleQRT - Request has bten aborted externally. 
Bit 1 .SPECIAL - Special handling it to bt applitd to thit 
rtquttt; for disc, indicatts a nenory 
nanagentnt request. 
.DIRG - Diagnostic request (not used). 



Bit 
Bit 
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Bit 
Bit 



Bit 
Bit 



oit 
Bit 



.SBUF - Systen Buffer. Target is a tytten buffer 
uhose index is relative to the start of 
the SBUF table. 



4 .IOUPKE - Uake caller on completion of request. 

5 .BLOCKED - Blocked I/O. Caller is waited in RTTRCHIO 

until request is conpleted. 

6 .COnPLETED - Rtque*t has bten conpltted and caller auoktn 

if ht had sptcifitd. 

7 .DRTRfRZN - Data segnent has been nadt present and it 

frozen. 

8 .hRnERROPD • nPfl error on data segnent nake present. 

9 .PREO • This request has been started but uat 

pretnpted by a nt 
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/fp^ 



/#*N 



I/O 



I/O Queue Elenent (Cont.) 



Bit 10 .SFAIL - Start SIO failure in HP. 
Bit 11 .PFAIL - The I/O has been aborted beeaute of a 
pouerfail. 
Bit 12/13 .PREEHPT - Preenptive type code: 

1 - eoft 

2 - hard 

Bit 15 .HSGOONE - P. nessage request reply has completed. 

QLINK - Table relative index of next IOQ elenent; points to first 
word of elenent. 

QLOEV - Logical Device Nunber. 

QMSC - Hiscellaneous request dependent storage available to driver. 

QDSTN - If SYSBUFRs is clear then this is the DST nunber of the target 
data segnent; if bit is set then buffer address is a OB offset 
value instead of segnent relative offset (mplenented for 
NOURIT 10 and NOBUFF) - S(Uord 4(0:1) - Stackflag - If set 
is DB relative. 

QRDDR - Offset in data segnent or systen buffer table to target data 
buffer. 

QFUNC.FUNC - Function code and qualifiers as specified by driver. 

QUBCT - On initiation specifies the uord count if positive or byte 

count if negative; at conpletion of the request this location 
contains the actual transmission count in the sane units as the 
call (Certain control requests return data through this 
location). 

QPRR1 - Paraneter one, defined by driver. 

QPRR2 - Paraneter tuo, defined by driver. 

QSTRT - .QUALIFIER - R code uhich further defies or qualifies the 

general status; defined by the driver. 
QSTRT - .STATUS - General Status. Indicates the current and resulting 

state of the request according to the follcuing codes: 

- Not started or auaiting conpletion. 

1 - Successful conpletion. 

2 - End-Of-File detected. 

3 - Unusual condition. 

4 - Irrecoverable error. 

QPCBN - .PCB - Nunber of process uhich nade this request; zero if 
not associated Mith any process and IOQ it to bt 

returned by the systen. 

Uord 13 bit - Queue elenent is on free list. 
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- Pending 



I/O Svsten Status Returns 



1 - Uaiting for conpletion 

2 - Doing error recovery 

3 - Not ready uait 

4 - No unte ring uait 

5 - Neu paper tape uait 



STRTUS Z 



10 
20 
30 

40 
50 



1 - Successful 

- Noraal 1 

1 - Read terminated uith special character 11 

2 - Tape retry for success required 21 

3 - Lou tape or end-of-tape after urite 31 

2 - End-Of-File 

1 - Physical end-of-file 12 

2 - Data 22 

3 - End-of-data 32 

4 - HELLO 42 

5 - BYE 52 

6 - JOB 62 

7 - End-of-job 72 

3 - Unusual Condition 

1 - Terminal parity error 13 

2 - Terminal read timed out 23 

3 - I/O aborted externally 33 

4 - Data lost 43 

5 - Data set not ready or disconnect, 53 

or unit not online 

6 - Aborted because of pouer fail 63 

7 - BOT and BSR, BSF request 73 

10 - Tape runauay 103 

11 - EOT and urite request 113 

12 - No urite ring after request to operator 123 

13 - End-of-tape [paper tape lou) 133 

14 - Plotter Unit suitch reached 143 

15 - Enable subsysten BRERK and no CONTROL Y PIN 153 

16 - Read tine returned overflow 163 

17 - BRERK stopped read 173 

20 - Urite and no card in uait station 203 

21 - Device pouered on - operating environment lost 213 
27 - VFC has been reset 273 
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I/O Svsten Status Returns (Cont.) 

STRTUS Z 



4 - Irrecoverable Error 

- Invalid request 

1 - Transnission error 

2 - I/O tineout 

3 - Tining error 

4 - SIO failure 

5 - Unit failure 

6 - Invalid disc address 

7 - Tape parity error 

11 - Paper tape tape error 

12 - Systen error 

13 - Invalid SBUF index 

14 - Channel failure, tineout or no response from 

the controller 

15 - Uninitialized nedia (LINUS) 
. 16 - No spare blocks available 

17 - Deleted record detected on IBI1 floppy disc 

20 - Labeled device unavailable after reel suitch 

21 - Parity error detected on PHI connand (EPOC) 

STRTUS Z XLOG 



5 - Error In Data Control Information 

- Invalid iten nunber 5 

1 - Invalid access for iten 15 

2 - Failure in FOPEN or FRERD 25 

3 - Parity change in S bit node 35 

4 - Invalid infornation file format 45 

5 - Checksun error in information 

file 55 

6 - Passed value less f-an 

nininun 

7 - Passed value greater than 

naxinun 

10 - Passed value is unsupported 

11 - Co jit less than required to 

return all infornation 

12 - Count greater than available 

for storing infornation 

13 - Passed values not in ascending 

oroer 

14 - Passed character has other 

defined function 



4 

14 
24 
34 
44 
54 
64 
74 
114 
124 
134 
144 

154 
164 
174 
204 
214 



VRUD RCCESS 
FS ERROR NUnBER 



I/O 



I/O Queue Ele nent for 7976R magnetic Tact 



1 2 3 4 5 6 7 t 9 10 11 12 13 14 15 HNEHONIC 

I — I — I — I — I — I — I — I — I — I — I — I — I — I — i — I — I e . 

Z0| REQUEST DEPENDENT FLAGS IQFLRG 

, — . 1 



11 
I 

I- 

21 
3 
4 
5 



SYSDB RELATIVE POINTER TO THE IOQ 
NEXT IOQ ELEHENT - POINTS TO THE 
FIRST UORD OF THE ELEHENT 



I QLINK 



QLDEV 



LOGICAL DEVICE NUR8ER 
—I — I — I — I— I 1 1 1 

R| Bl F| GIBOI TOUT | FSCNTR | BSCNTR I RTCNTR IQMSC 
-l-l-l-l-l 1 1 1 

SI 
-I 



65 


MN.VfeLUE RLLOUED 


75 
105 


flAX.VRLUE RLLOUED 


115 


niN. SPACE NEEDED 


125 


flRX.SPfiCE RVRIL 


135 


OFFSET OF ELEnENT 


145 


OTHER FUNCTION 



12 
13 



OFFSET IN THE DATA SEGHENT OR SYSTEO 
BUFFER TABLE TO THE TRRGET DRTA 
BUFFER 



QDSTN 
QRDDR 



| FUNCTION CODE 
I 



PRRRRETER 1 - USED ONLY FOR RERDS 
CONTAINS THE EOF SPECIFICATION 
IN BITS (13:3) 



QFUNC 
QUBCT 
QPRR1 

QPAR2 



PARAMETER 2 - USED ONLY FOR URITES 
IF BIT (13:1) IS SET, URITING 
PRST EOT IS RLLOUEO I 

1 1 1 

I QUALIFIER I STATUS IQSTAT 

1 1 1 

PCB NUflBER I 



QFLRG - Request 
Bit RBORT 



Bit 1 SPECIAL 
Bit 2 DIAG 



Bit 3 SYSBUfF 



Bit 4 IOURKE 
Bit 5 BLOCKED 



Bit 6 COnPLETED 
Bit 7 DRTAFRZN 
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flags: 

Abort this request and return an error 
indication to the caller. 
Rpply special handling to this request (unused). 
This is a request from the diagnostic subsysten 
(unused). 

Target is an index relative to the SBUF Table of 
the data buffer. 

Uake caller on conpletion of request. 
Blocked I/O. The caller is uaited in RTTRCHIO 
until the request is conpleted - inplies IOURKE. 
The request has been conpleted and the caller 
auakened if he had requested (uith IOURKE). 
Set by the memory managenent routines (nAfl) uhen a 
HAKEPRESENT request is successfully conpleted and 
indicates the data segnent is frozen in nemory. 
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Bit 8 RAflERRORD - On error has occurred uhili MM uas trying to 
nake tht target data segncnt present and freeze 
it in nenory. 

Bit 9 PREQ - Unused. 

Bit 10 SFRIL - Dclaytd failure of SIO instruction - if a call to 
STRRT'HPIB retulttd in tht request bung addtd to 
tht channel qutut, thit bit indicattt that tht SIO 
instruction failtd uhtn tht requtst uas stltcttd 
for tKtcution. 

Bit 11 PFRIL - Tht requtst uas aborttd because of a systtn pouer 
failure. 



QOSTN 



• If QFLRG.(3:1) « cltar thtn this is tht OST nunbtr of tht 
targtt data ttgtttnt - if S is stt, QROOR is 08 relativt. 



QfllSC - Orivtr requtst dependent flags and ceunttrt ■ 
trror retnts. 



uttd nostly for 



QUBCT 



Indicattt an trror retry it in progress. 
B - Backspact record proctssing for an trror retry is in 

progress. 
F - Forward spact record processing for an trror retry it 

in progress. 
C - Gap proctssing for an trror retry is in progress. 
BO - Backspact record due to a data EOF processing is in 

progress. 
TOUT - 6IC tined-out counter. 
FSCNTR - Forward space record counter. 
BSCNTR - Backspace record counter. 
RTCNTR - Error retry counter. 

• On initiation, specifies the uord count (> 0) or byte count 
(< 0) - at cenpletion of the request this location contains 
the actual transniseion count in the sane units (bytes or 
uorti) as in tht request. 



QSTRT - PCB nunber and request conpletion status. 

PCBN - The Process Control Block (PCS) nunber of the process 
uhich nade this request - if zero, the request is not 
associated uith any process and the IOQ elenent is to 
be returned by the systen uhen the request has conpleted. 
STATUS - General status indicating the final state of the 
request - the following codes are used: 

- Not started or euaiting conpletion. 

1 - Succttsful conplttion. 

2 - End-of-filt dtttcttd. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER • A code uhich further defines or qualifies the 
general status (see the section Driver Return 
Status Cedes on the next page). 
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I/O Qutut El »«»nt flOO) for CIPER 



ZO 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 IWEnONXC 

l-l-l-l-i-:i::l--l--!"l : -l~l--l-l-l-l--L 



10 



12 
13 



REQUEST DEPENDENT FLAGS 



IQFLAG 
-I 

IOQ TABLE INDEX TO THE NEXT IOQ ELEflENT IQUNK 
POINTS TO FIRST UORD OF ELEflENT | 

1 

LOGICAL DEVICE NUflBER IQLOEV 



1 

ionise 

1 

I QOSTN 
1 

OFFSET IN THE DATA SEGflENT OR SYSTEfl IQRDDR 
BUFFER TABLE TO THE TARGET DATA BUFFER I 

1 1 

| FUNCTION CODE FOR IQFUNC 
| THIS REQUEST | 

1 1 

I QUBCT 

IQPRR1 
1 

IQPRR2 

( QUALIFIER IRSTATUS IQSTAT 
1 1 1 

IQPC8 
1 



PARRflETER 1 



PARAHETER 2 



PCBN 



QFLAG - Request dependent flags: 
Bit ABORT - Abort this request and return an error indication 

to the caller. 
Bit 1 SPECIAL - Apply special handling to this request (unused). 
Bit 2 DIRG - This is a request fron the diagnostic subsysttn. 
Bit 3 SYSBUFF - Targtt is an index relative to the SBUF Table of 

the data buffer. 
Bit 4 IOUAKE - Uake caller on conpletion of requeet. 
Bit 5 BLOCKED - Bloekcd I/O. The caller is uaited in ATTACHIO 

until the requeet is conpleted; inplies IOUAKE. 
Bit 6 CORPLETEO - The request has been conpleted and the caller 

auakened if he had requested (uith IOUAKE). 
Bit 7 DATAFRZN • Set by the nenory nanagenent routines (HAH) uhen a 

ftRKEPRESENT request is successfully conpleted and 

indicates the data segncnt is frozen in nenory. 
Bit 8 RRItERRORO - An error has occurred uhile HAH uas trying to 

nake tht targtt data segnent present and freeze 

it in nenory. 
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Bit 9 PREQ 
Bit 10 SFRIL 



Bit 11 PFAIL 



- (Unused). 
• Delayed failure of SIO instruction; if a call to 

STRRTIO resulted in the requeet being added to 
the channel queue, this bit indicates that the SIO 
instruction failed uhtn the request uas selected 
for execution. 

- The request uas aborted because of a systen pouer 
failure. 

QOSTN • If QFLAG. (3:1) ie clear then thie is the DST nunber of the 
target data segncnt; if S is set, QRDOR is 08 relative. 

QUBCT - On initiation, specifies the uord count (> 0) or byte count 
(< 0); at conpletion of the request this location contains 
the actual transnission count in the <ant units (bytta or 
uordt) as in tht requtst. 

QSTRT - PCB nunbtr and requtst conplttion status. 

PCBN - Tht Procsss Control Block (PCB) nunbtr of tht process 
uhich nade thie requtst; if zero, the request is not 
associated uith u\y process and the IOQ elenent is to 
be returned by the systen uhen the request has conpletsd. 

RSTATLIS - General status indicating the final state of the 
request - the follouing codes are used: 

- Not started or auaiting cenpletion. 

1 - Successful conpletion. 

2 • End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER - A code uhich further defines or qualifies the general 
etatue (see the section Driver Return Stat-s Codes 
on the next page). 



OPERATION FUNCTION 


PARAHETERS 


READ 





None 


URITE 


1 


None 


FILE OPEN 


2 


None 


FILE CLOSE 


3 


None 


DEVICE CLOSE 


4 


None 


CIPER INIT 


184 


None 



Genial Status (1? 


;.21 


Qualifvina Statue (8:5) Overall (8:8) 


- Pending 




1 - Uaiting For Conpletion Z10 
3 - Not Ready Uait Z30 


1 - Succeeeful 




- No Errors Z1 


2 • End-of-Filt 




(Unused) 



3 - Unusual Condition 



4 - Irrecoverable Error 



3 - Requeet Aborted 

6 - Pouerfail Abort 
Z21 • Device Powered Up 



Z33 

Z63 
Z213 



- Invalid Requeet Z4 

1 - Tranefer Error Z14 

2 - I/O Tined Out Before Conplete Z24 

4 - SIO Failure Z44 

5 - Unit Failure ZS4 
Z12 - Syeten Error Z124 
Z14 - Channel Failure Z144 
Z21 - Parity Error Z214 
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2608 Lint Printer I/O Queue Elenent (HP-IB Svstens) 



I 

Z0| 

I 

11 

I 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

REQUEST DEPENDENT FLAGS 

SVSdTrELATIVE POINTER TO THE NEXT IOQ 
ELEMENT - POINTS TO FIRST ELEMENT 



RNEHONIC 
I 

I QFLAG 
-I 
IQUNK 



21 



LOGICAL DEVICE NUMBER 
.,.., 1 



3 1 PP I PE I HC I TOUTCNTRI 
l-l-l-l 1- 

4| SI 
|--|- 



I URITCODE 
-| 



5| 

I 

I 

I- 
61 

I 

I- 
7\ 

I- 
101 

I- 
111 

I- 
121 

I- 
131 



OFFSET IN THE DflTR SEGMENT OR SYSTEI1 
BUFFER TABLE TO THE TARGET DATA 
BUFFER 
1 

I FUNCTION CODE FOR 
I THIS REQUEST 



-I- 



IQLDEV 
-I 

IQMSC 
-I 

IQDSTN 
-I 

IQADDR 

I 

I 
-I 

IQFUNC 

I 



1 



PARAMETER 2 



PCS NUMBER 



1 

QUALIFIER | STATUS 



IQUBCT 
-I 

IQPAR1 
-I 

IQPAR2 
-I 

IQSTAT 
-I 

IQPC8N 



QFLAG 
Bit 



- Request dependent flags. 
ABORT 



Bit 
Bit 



1 SPECIAL 

2 DIRG 



Bit 3 SYSBUFF 



Bit 
Bit 



4 IOURKE 

5 BLOCKED 



- Rbort this request and return an error indication 
to the caller. 

- Rppiy special handling to this request (unused). 

- This it a request fron the diagnostic subsysten 
(unused). 

- Target is an index relative to the S8UF Table of 
the data buffer. 

- Uake caller on conpletion of request. 

- Blocked I/O. The caller is uaited in RTTRCHIO 
until the request is conpleted; inplies IOURKE. 

Bit 6 COnPLETED - The request has been conpleted and the caller 
auakened if he had requested (uith IOURKE). 
Set by the nenory nanagenent routines (MAM) uhen a 
MAKEPRESENT request is successfully conpleted and 
indicates the data segnent is frozen in ntnory. 
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Bit 8 rmnERRORO 



Bit 9 PREQ 
Bit 10 SFRIL 



Bit 11 PFRIL 



- An error has occurred uhile HAH uas trying to 
nake the target data segnent present and freeze 
it in nenory. 

- (Unused). 

- Delayed failure of SIO instruction; if a call to 
STARTIO resulted in the rtquest being added to 
the channel queue, this bit indicates that the SIO 
instruction failed uhen the request uas selected 
for execution. 

The request uas aborted because of a systen pouer 
failure. 



QMSC - Driver request dependent flags and counters 
PRE'TO'POST - Pre to post spacing change flag. 
PEJECT - Last operation uas a page eject. 

rtflSTERCLR - Haster clear done to clear pouerfail bit in status, or 
Hatter clear needs to be done fron not ready condition. 
TOUTCNTR - Channel tine-out rttry counter. 
URITCODE - Indicates type of uait: 

- Neu request. 

1 - Conpletion uait. 

2 - Not ready uait. 

QDSTN - If QFLAG. (3:1) is clear then this is the DST nunber of the 
target data segnent; if S is set, QADDR is OB relative. 

QUBCT - On initiation, specifies the uord count (> 0) or byte count 
(< 0); at conpletion of the request this location contains 
the actual transmssicn count in the sane units (bytes or 
uords) as in the request. 

QSTRT - PCS nunber and request conpletion ttatut. 



Bit 7 DRTAFRZN 



>**n 



I/O 



2608 Line Printer Request Codes 



Operation Function 



Paranetert 



URITE 



1 



PI 



FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE 4 

READ STRTUS Z17 



VFC SET 



TRe SET 



Z100 



■ Vertical Fornat Specification. 

1 - Use 1st data char as fornat sptc. 
Z53 - "♦", print and suppress spacing. 
Z55 - "-", print and triple space. 
Z60 - "0", print and double space. 
X61 - "1", print and top of forn. 
Z200-Z277 - Print and space n-Z200 lines. 
Z300-Z377 - Print uith channel n-Z277. 
Rll others - Print and single space. 

P2 - Space Rode Flags. 
(15:1) - Prespace flag. 

If set, print then fill buffer. 
If clear, fill buffer then print. 
(14:1) - No page stepover flag. 

If set, single and double space 
uithout stepover (66 lines/page). 
If clear, single and double space 
uith stepover (60 lines/page). 

Page eject if not at top of forn. 

Page eject if not at top of forn. 

Page eject if not at top of forn. 

Read I/O status. 
Count - buffer nust be at least 2 bytes. 

Load VFC RRM. 
Count - Forn length in uords 

(0 loads RRH fron internal ROH). 
P1 - 6 for 6 LPI or 8 for 8 LPI 

tny other value defaults to 6 LPI. 

Sets logical colunn definition. 
P1 - to 15, any other value defaults to 15. 



PCBN 



STRTUS 



QUALIFIER 



The Process Control Block (PCB) nunber of the process 

uhich nadc this requett; if zero, the request is not 
associated uith any process and the IOQ elenent is to 
be returned by the systen uhen the requett hat conpleted. 

- General status indicating the final state of the request; 
The follouing codes art used: 

- Not started or auaiting conpletion. 

1 - Successful conpletion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

- R code uhich further defines or qualifies the general 
statut (see the section Driver Return Status Codes 
above). 
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ZO 

1 



5 



2619R I 2631 Une Printer IOQ Elenent (HP-IB Svstens) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 MNEMONIC 

~|--I~I~I--I--I--I--I~I--M~I--I--I--I--I m 
REQUEST DEPENDENT FLAGS IQFLRG 



SYSD8 RELATIVE POINTER TO NEXT IOQ 
ELEMENT • POINTS TO FIRST UORD 
OF ELEflENT 



-I 



LOGICAL DEVICE NUHBER 

3 PP | PE | PF | TOUTCNTRI I URITCODE 
.. | .. j .. j 1 1 

4 SI 
-I- 



QUNK 



QLDEV 
QMSC 



OFFSET IN THE DRTR SEGMENT OR SYSTEN 
BUFFER TABLE TO THE TARGET DATA 
BUFFER 
1- 



FUNCTION CODE 



IQDSTN 
-I 
IQRDDR 



IQFUNC 
-I 

IOUBCT 
-I 

IQPRR1 



-I 



10| PARAMETER 1 

111 PARAMETER 2 IQPP.R2 

121 I QUALIFIER I STATUS IQSTAT 

131 PCB NUMBER IQPCBN 

, | 



QFLAG 
Bit 



• Request dependent flags. 
ABORT 



Bit 
Bit 



Bit 3 SYSBUFF 
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Abort this rtqucht and return *i error indication 
to the caller. 

1 SPECIAL - Apply special handling to this request (unused). 

2 DIAG - This is a request fron the oiagnep»:c subsysten 
(unused). 

- Target is tn mde» reiat.«e to *he SBUF Table of 

the data buffer. 
Bit 4 IOURKE - Uake caller on co^letic cf re;u*st. 
Bit 5 BLOCKED • Blocken I/O. The c»lier .s uaited ir. 0TTRCHIO 

until the rtquest is conpleted; mplits Iu»RKE. 
Bit 6 COAPLETED - The rtquest has beer, conpleted and the caller 

auakened if he had requited (fcith IOURKE). 
Bit 7 DRTRFR2N - Set by the nenory nanagenent routines (MM) gh«n a 

RRKEPRESENT requett is successfully corpleted and 

indicates the data segnent .s frostn m nencry. 
Bit 8 nflnERRORD - Rn error has occurred uhile nfin uas trying to 

nake the target data segnent prMtnt and 'rf tze 

it in nenory. 
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Bit 9 PREQ 
Bit 10 SFRIL 



Bit 11 PFRIL 



- (Unused). 

- Delayed failure of S10 instruction; if a call to 
STRRTIO rttulttd in the request being added to 
the channel queue, this bit indicates that the SZO 
instruction failed uhen the request uas selected 
for execution. 

• The request uas aborted because of a systen pouer 
failure. 



QniSC - Driver request dependent flags and counters for 2631. 
PRE' TO' POST - Pre to post spacing change flag. 
PEJECT - Last operation uas a page eject. 
TOUTCNTR - Channel tine-out retry counter. 
POUERFAIL - Pouer fail flag indicates pouer fail occurred. 
UAITCODE - Indicates type of uait: 

- Neu request. 

1 - Conpletion uait. 

2 - Not ready uait. 

OOSTN - If Qf LAG. (3:1) is clear then this is the OST nunber of the 
target data segnent; if S is set, QRODR is DB relative. 

QUBCT - On initiation, specifies the uord count (> 0) or byte count 
(< 0); at conpletion of the request this location contains 
the actual transmssion count in the sane units (bytes or 
uords) as in the request. 
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Fornat for 2619ft 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

13 1 PP I PE I PF | TO I BF | I URITCODE I QMSC 
l-l-l-l-l-l 1 1 



I 
I 
I 121 



I 



I- 



I- 



-I- 



-I- 



-I 



QUALIFIER ISTRT IQSTAT 
1- 1 



QMSC - Oevice dependent flags: 

TOUTCNTR - (TO) Channel tineout flag. 

BUF'FILL - (BF) Buffer fill optration in progress. 

QSTRT - PCB nunber and request conpletion status: 
PCBN - The process control block (PCB) nunber of the process 
uhich nade this request; if zero, the request is not 
associated uith any process and the 100 elenent is to 
be returned by the systen uhen the request has conpleted. 
STRTUS - General status indicating the final state of the request. 
The following codes are used: 

- Not started or auaiting conpletion. 

1 - Successful conpletion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER - R code uhich further defines or qualifies the general 
status (see the section Onver Return Status Codes 
earlier in this chapter). 
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2619 Line Printer Reouest Codes 



I/O 



2631 Line Printer Reoueet Codes (HP-IB) 



Operation Function 
URITE 1 



FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE 4 

RERD STRTUS XI 7 



*IOENTIFY 



♦SELF TEST: 
INIT-C'E 



Z110 

X111 
Z112 



•LOOPBPCK TEST: 
UP.7 DATA Z113 
READ ORTR 2114 



Paranetfrt 

P1 - Vertical Fornat Specification. 
1 - Use 1st data char as fornat 
specification. 

X53 - "♦", print and suppress spacing. 

Z5S - "-", print and triple space. 

Z60 - "0", print and double space. 

Z61 - "1", print and top of for*. 

X200-Z277, Print and space n-X200 lints. 
X300-X312, Print uith channel N-X277. 

X320 - Fill Line Printer Buffer Only. 

Rll others, print and single space. 

P2 - Space node Flags. 

(15:1) - Prespace flag. 

If set, print then fill buffer. 
If clear, fill buffer then print. 

(14:1) - No page stepover flag. 
If set, single and double space 
without stepover (66 lines/page). 
If clear, single and double spaee 
uith stepover (60 lines/page). 

Page eject if not at top of font. 

Page eject if not at top of font. 

Page eject if not at top of font. 

Read I/O status. 
Count - buffer size. 

Return ID value in Bank & Buffaddr. 



Subtest nunber to execute in Bank and Buffaddr 
(subtest nunber ranges fron to 7). 
Subtest result returned in Sank & Buffaddr. 



Data to LP in Bank & Buffaddr (PING). 

Data fron LP read into Bank & Buffaddr [PONG]. 

Count - Buffer Size (256 bytes nax). 



Pee ration Function 
URITE 1 
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FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE 4 

RERD STRTUS XI 7 



VFC SET 



X100 



paranftirs 

PI - Vertical Fornat Specification. 
1 • Use 1st data char as fornat 
specification. 

X53 - "♦", print and suppress spacing. 

X55 - "-", print and triple space. 

X60 - "0", print and double space. 

X61 - "1", print and top of font. 

X2O0-X277, print and space N-X200 linee. 
X300-X307, print uith channel N-X277. 

X320 - Fill Line Printer Buffer Only. 

Rll others, print and single space. 

P2 - Space Rode Flags. 

(15:1) - Preepace flag. 

If sst, print then fill buffer. 
If clear, fill buffer then print. 

(14:1) - No page stepover flag. 
If eet, single and double space 
without stepover (66 lines/page). 
If clear, single and double space 
uith etepover (60 lines/page). 

Page eject if not at top of font. 

Page eject if not at top of font. 

Page eject if not at top of font. 

Read I/O status. 
Count • 1 byte nininun required. 

LOADS VFC RRTI 

PI - 1 - 1 LPI (lines per inch) 

2 - 2 LPI 

3 - 3 LPI 

4 - 4 LPI 

5 - 5 LPI 

6 - 6 LPI 
8 - 8 LPI 

12 - 12 LPI 

Rny other value defaults to 6 LPI. 
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I/O Qutut Elen ent For HP-IB Card Reader 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 IWEflONIC 
.-,.-,-1-1-1-1-1-1-1-1-1-1-1-1-1-1 
REQUEST OEPENOENT FLAGS (SEE BELOU) | QFLAG 

"sYSOBRELflTIVE POINTER TO NEXT 100 ELEHENT. IQUNX 
POINTS TO FIRST UORD OF ElfflENT. | 

, 

LOGICAL DEVICE NUPJER IOLDEV 
1 

AUXIURRY BUFFER FLAG. IQMSC 

.., 1 

St IF 0FLAG.(3:1) IS CLEAR THEN THIS IS THE IQDSTN 
| OST NUJ18ER OF THE TARGET DATA SEGflENT. IF | 
i S IS SET, QADOR IS D8 RELATIVE. | 

.., 1 

OFFSET IN THE DATA SEGflENT OR SYSTEtl BUFFER IQADDR 
TABLE TO THE TARGET DATA BUFFER. I 

, 1 

I FUNCTION CODE FOR IQFUNC 
I THIS REQUEST. (SEE I 
I NEXT SECTION. ) | 

, , 

ON INITIATION, SPECIFIES THE UORD COUNT (X»|QU8CT 
OR BYTE COUNT (<0). AT COflPLETION OF THE I 
REQUEST THIS LOCATION CONTAINS THE ACTUAL I 
TRANSI1ISSI0N COUNT IN THE SAflE UNITS (BYTES | 
OR UORDS) AS IN THE REQUEST. I 

"pARAflETEIU. CONTAINS THE EOF SPECIFICATION IQPAR1 
1 

PARAflETER 2. CONTAINS THE DATA flODE IQPAR2 
SPECIFICATION IN BITS (11:2). (SEE BELOU CARD I 
READER REQUEST CODES FOR DETAIL INFQRflATIQN) | 

| QUALIFIER I STATUS IQSTAT 

, , 1 

PCB NUnBER IQPCBN 
1 
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f^ 



I/O 



g go P4fc Rnvtrt i/o queue umn\ [m) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 RNCIUWIC 
M-I-MH-I-I-I-M-M-MH- 
0| REQUEST DEPENOENT FLAGS (SEE BELOU) 
, 

1 | REQUEST URGENCY CLASS 



I- 
21 LOGICAL DEVICE NUflBER 

, l-l-l-l-l 1~|-|~ 

3|CHANF|RS|0P|in|SR|RTRAN|LF|SP| 

l-l-l-l-l-l-l l-l-l- 



-I- 



IQFLRG 

QURGCLASS 
QLDEV 



-I 



10 



12 
13 

14 
151 



I UAITCODE QflISC 

Sj OSf (IF PROCESS DISC I/O) QDSCTN 

| OR 

I DST (IF SEGflENT TRANSFER) [S'STRCK] 



OFFSET IN THE DATA SEG (IF PROCESS DISC I/O) QRDDR 

OR 
ADDRESS IN BANK (IF SEGflENT TRANSFER) 



UNIT! 



| FUNCTION CODE FOR 
| THIS REQUEST. 
-I- 



ON INITIATION, SPECIFIES THE UORD COUNT (>0) QUBCT 
OR BYTE COUNT (<0). AT COHPLETION OF THE 
REQUEST THIS LOCATION CONTAINS THE ACTUAL 
TRANSniSSION COUNT IN THE SAflE UNITS (BYTES 
OR UORDS) AS IN THE REQUEST. 



P1 - PARAHETER 1 (USUALLY HIGH ORDER OF 
CURRENT LOGICAL DISC ADORESS (CLDA1]) 

P2 - PARAflETER 2 (USUALLY LOU ORDER OF 
CURRENT LOGICAL DISC ADDRESS [CLDA2]) 



QUALIFIER 



PCB 



I STATUS 
•I 



QFUNC 



QPAR1 

QPAR2 

QSTRT 
QPCB 



SYSBRSE RELATIVE INDX OF PREVIOUS REQ IN QUEUEIQPREVREQP 



-I 



SYSBASE RELATIVE INOX OF NEXT REQ IN QUEUE IQNEXTREQP 

QSEGIDENT 
-I 



- SEGIDENTIFIER (IF SEG TRANSFER) 



16 
I 
171 ( 

20IDISPLACEHENT OF READ OR URITE FROH SEG BASE(fln)|QSEGOISP 
, 1 
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QFLAG - Request dependent flags. 



Bit ABORT 

Bit 1 SPECIAL - 

Bit 2 DIAG 

Bit 3 SYSBUFF 

Bit 4 IOUOKE 

Bit 5 BLOCKED 

Bit 6 CCHPLETEO - 

Bit 7 DATAFRZN - 

Bit 8 flflnESRORD - 



Bit 9 PREQ 
Bit 10 SFAIL 



Bit 11 PFAIL 



Abort this request end return an error indication 

to the caller. 

Apply special handling to this request. (Not used) 

This is a request fron the diagnostic subsystem 

Target is an index relative to the SBUF Table of 

the data buffer. 

uake caller on conpletion of request. 

Blocked I/O. The caller is uaited in ATTACHIO 

until the request is conpleted. Inplies IOUAKE. 

The request has been conpleted and the caller 

auakened if he had requested (with IOUAKE). 

Set by the nenory nanagenent routines (flAfl) uhen a 

flAKEPRESENT request is successfully conpleted and 

indicates the data segnent is frozen in nenory. 

An error has occurred uhile AAA uas trying to 

nake the target data segnent present and freeze 

it in nenory. 

(Not used). 

Delayed failure of SIO instruction. If a call to 

STARTIO resulted in the request being added to 

the channel queue, this bit indicates that the SIO 

instruction failed uhen the request uas selected 

for execution. 

The request uas aborted because of a systen power 

failure. 

QHISL - Auxiliary buffer flag used to indicated a read into the 
driver's buffer and not the user's buffer. 

QSTRT - PCB nunber and request conpletion status. 

PCBN - The Process Control Block (PCB) nunber of the process 
which nade this request. If zero, the request is not 
associated with any process and the IOQ elenent is to 
be returned by the systen when the request has conpleted. 

STATUS - General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting conpletion. 

1 • Successful conpletion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER - A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes 
earlier in this chapter. ) 
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QFLAG - Request dependent flags 



BitO ABORT 

Bit 1 nilREQ 

Bit 2 OIAG 

Bit 3 SBUF 

Bit 4 IOUAKE - 

Bit 5 BLOCKED - 

Bit 6 COflPLETED - 

Bit 7 OATAFRZN - 

Bit 8 WWERRORD - 



Bit 9 PREQUEUED 
Bit 10 SFAIL 



Bit 11 PFAIL 

Bit 12 CURREQ 
Bit 13 DISABLED 
Bit 14 DISATflPT 
Bit 15 nSGOONE 



Request hat been aborted externally. 

Request is for a segnent transfer. 

This is a request fron the diagnostic subsystem 

Target is an index relative to the SBUF Table of 

the data buffer. 

Uake caller on conpletion of request. 

Blocked I/O. The caller is uaited in ATTACHIO 

until the request is conpleted. Inplies IOUAKE. 

The request has been conpleted and the caller 

awakened if he had requested (with IOUAKE). 

- Data segnent has been present and is frozen. 

- An error has occurred uhile flRn uas trying to 
nake the target data segnent present and freeze 
it in nenory. 

- Request is queued into disc's request queue. 

- Delayed failure of SIO instruction. If a call 
to STARTIO resulted in the request being added 
to the channel queue, this bit indicates that 
the SIO instruction failed uhen the request uas 
selected for execution. 

- The request uas aborted because of a systen 
power failure. 

- Request is device's current request. 
• Request is disabled. 

- Attenpt to disable thie request. 

- A neesage request reply has conpleted. 



QLDEV.QLDEVN - Logical Device Nunber. 

QflISC - Driver request dependent flage and counters. 

CHAN' ERR' FLG - Channel error retry flag. 

RSTAT'FAIL'FLG - Request status failed flag. 

OPER'REQ'FLG - Operator requested releass flag. 

IH' FAULT' FLG - Internal naintenance fault flag. 

STAT' RTRY» FLG - Status error single retry flag. 

RTRANS'FLG - Retransnit required flag. 

LOAD' FLG - fledio load flag. 

SYS' PFAIL' FLG - Syst** pouerfail flag. 

UAITCODE - Indicates type of wait: 

- New request. 

1 - Conpletion wait. 

2 - Not ready wait. 

3 - Release/release deny wait. 

4 - IOQ defer wait. 

5 - DSCT read wait. 

6 - DSCT urite uait. 

7 - ^ynehronuation "'it. 
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QDSTN - If tytten bufftr it clear thtn thie it tht OST 
nunber of tht target data ttgntnt. If bit it 
ttt thtn bufftr addrttt it * OB offttt value 
instead of stgnent relative offttt (inplenented 
for NOURIT I/O and N08UFF). 

QROOR - Offttt in data eegnent or eyattn bufftr tablt to 
targtt data bufftr. 

QFUNC - Function codt and qualifier* at tpteifitd by 

driver. 

QSTRT - PCB rtunbtr and rtquctt cenplttion ttatut. 

PCBN - Tht Proctet Control Block (PCB) nunbtr of tht precttt 
uhich nadt thit rtquttt. If itro, tht rtquttt it not 
attociattd uith any procttt and tht IOQ tltntnt it to 
bt rtturntd by tht tytttn uhtn tht rtquttt hat conpltttd. 

STATUS - Gcntral ttatut indicating tht final ttatt of tht rtquttt. 

- Not ttarttd or waiting coitplttien. 

1 - Sucetttful cenplttion. 

2 - End-of-filt dtttcttd. 

3 - Unusual, but rtcovtrablt, condition dtttcttd. 

4 - Irrtcovtrablt trror hat occurrtd. 

QUALIFIER - R codt uhich further define* or qualifitt tht gtneral 
ttatut. (Stt tht ttction Driver Rtturn Statut Codtt. ) 
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INP I/O Qutut Elencnt (IOQ) 



1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 

|-|-|..|.-|~|~|~|~|~M-|~I l-l-l 

I00OIRBI 10 ISBIURIBLIC |FR|ER|RU|M |UC|PRnPT|TI|RR|QFLRG 

|..|-.|.-|-|-|-|-.|-|-|-.|-|-| I--I--I 

100 INDEX TO NEXT NEU REQUEST 1 LINK 

LOGICAL DEVICE NUHBER I0LOEV 



-I 

ionise 
-I 

IQDSTN 

-I 
IQRDDR 



1001 1 

I- 
I0Q2I 

I0Q31 HISCELLRNEOUS PRRRRETER 
M 

1004 1 DB| OST NUHBER 

I00SI TARGET DRTR BUFFER ROORESS 

I0Q6I QUEUE I SERVICE I FUNCTION COOE I QFUNC 
, 1 1 1 

I0Q7| UQRD (♦) OR BYTE (-) COUNT IQUBCT 

I0Q1OI PRRRHETER 1/RERO DRTR COUNT IQPRR1 

| 1 

I0Q11I PRRRRETER 2 IQPRR2 

| 1 - 1 - 1 1 1 

I0Q12I ERROR CODE |UR|LS| ICSTRTUS IQSTRT 

, l-l-l 1 1 

I0Q13I PCB NUHBER IQPCBN 

, 1 



G.23.00 
13- 116 



I/O 



INP IOQ Fitld Dtfinitiont 

QFLRG - Flege and Control Information. 

.ABORT - If ttt, thtn rtquttt hat bttn aborttd. 

.DIRG - Oiagnottic Flag. Not uttd. 

.SVS8UFR - Sytttn Bufftr Flag. Not uttd. 

.IOURKE - Uakt calltr en ecnplttion of rtquttt. 

.BLOCKED - Blocktd I/O. Calltr it uaittd in ATTACHIO until tht rtquttt 
it conpltttd. Inplitt uakt. 

.CORPLETED - Rtquttt hat bttn conpltttd and calltr auoktn (if tpteifitd) 
and rtquttt it no longtr kneun to tht Driver. 

.DRTRFRZN - If ttt, tht targtt data ttgntnt it froxtn in ntnory. 
Stt by ItAR uhtn a dtlaytd uakt prtttnt rtquttt it 
tucctttfully conpltttd. 



.RAHERRD 



• A RRR trror hat oeeurrtd in trying to ntkt prtttnt and 
frttzt tht targtt data ttgntnt. 



.RERDURITE • If ttt, thtn thit rtquttt alio** data to bt rtetivtd afttr 

data it ttnt. Tht rtad targtt bufftr offttt it in QPAR1 and 
tht rtad targtt bufftr ltngth it in QPRR2. 

.HELD - If ttt, procttting of thit rtquttt hat bttn tutptndtd 
btcauat INP did not have bufftr tpaet availablt. 

.UOROCOUNT - If ttt, QUSCT tpteifitd uordt, tltt QU8CT tpteifitd 
byttt. 

.PREERPT - Prttnpt Codt. Rot uttd. 

.TIRE - If ttt, a toftuart tintout it ttarttd uhtn tht rtquttt 
initiation ntttagt it ttnt to INP and tht Rtquttt 

Cenplttion ntttagt nutt bt rtetivtd btfort tht tintout 
tMpirtt. 

.RBCRTER - If ttt, thit it a rtquttt to abort another rtquttt. 

QUNK - SYSDB rtlativt pointer to tht next ntu IOQ eltntnt. 

QLDEV - Holdt Logical Dtviet Nunbtr and Currant Qutut Indtn. 

.OLDEVN • Logical Dtviet Nunbtr of Controller. 

QniSC - Ritctllantout parantttr. Uat varitt uith Function Cede. 
Stt INP FUNCTIONS for tptcific ntaning. 

QDSTN - DST Nunbtr and Rtquttt Statt. 
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.DBFLRG 

QROOR 
QFUNC 
.QUEUE 



- If ttt, QRDDR it tht offttt fron DB to tht targtt 
bufftr, otheruitt QRODR it tht offttt fron tht DST batt. 

- Offset to targtt data area fron data ttgntnt batt or D6. 
• Error Codt and Function. 

- DIT rtlativt indtt to head of qutut holding thit rtqutttt. 
- Input Qutut. 

9 - Rtady Qutut. 
11 • Rctivt Qutut. 
13 • Uaittd Qutut. 

.SERVICE - Service cede. Thit fitld controls the operations to be done 
for thit rtquttt and itt ditpotition on conpletien. 

• Send ntttagt only, no data. 

1 - Send neeeage and data. 

2 - Rove data fron trace urite to trace read bufftr. 

3 - novo Logical Driver Statue Block to target buffer. 

4 - Thie it a rtquctt to abort another rtquttt. 

5 - Rtttagt hat been eent to INP. 

6 - Receive data fron INP. 

7 - Ittut a poutr on react. 

8 • Conplttt rtquctt uhtn I0STRTE it inactivt. 

9 - Soft fibort pending on thit rtquttt. 

10 - Stnd data rtquttttd uith Soft fibort ponding. 

11 - No ttrvict currently rtquirtd for thit rtquttt. 

.FUNCTION - Function Code at tpteifitd by dnvtr. 

QUBCT - Uord or byte count. n»y also bt uttd to return information 
certain functions. On initiation, it specifies a uord count 
positive or a byte count if negative. It it c on v tried to a 
count during prtproctsaing of the requeet uith the eence kept 
in the flag UOROCOUNT. Rt cenplttion, the actual traanieeien 
count ie returned in thie uord uith the tana tense ae the 
original epecification. 

QPAR1 - Parantttr one at defintd by tht drivtr. Uhen 

a rtquttt hat been conpltttd and data it to bt received, tht 
uord contains tht bytt count of the data to be received. 

QPRR2 • Paranetcr tuo ae defined by the driver. 

QSTRT • Caller PCB Hunter and request conpletien status. 

.ERRORCODE - Tht Irrtcovtrablt Error Code at defined in CS ERS. 

.LS 



^*%" 



.UR 



- Line State. If fet, the line is connected. This field ie 
valid only for read and urite conrietions. 

• If set, this uat a urite request conpletien. 
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.CSTRTUS 



- Encoded Conpletion Status. 

1 - Successful Conplction. 

2 - End of Transmssion. 

3 - Irrecoverable Error Conplction. 

4 - Unrecovered Recoverable Error Conplction. 

5 - Catastrophic Controller Error. 

- PCB Nunber of the originator of this request. If zero, this 
100 elenent xs returned by the Logical Driver uhen the 
request is conpleted. 



I/O 
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QFLRG - Request dependent flags. 



Bit ABORT 

Bit 1 nnREO 

Bit 2 DIRG 

Bit 3 SBUF 

Bit 4 IOUAKE - 

Bit 5 BLOCKED - 

Bit 6 CQHPLETED - 

Bit 7 DATRFRZH - 

Bit 8 tUMERRORD - 



Bit 9 PREQUEUEO 
Bit 10 SFRIL 



Bit 11 PFRIL 

Bit 12 CURREQ 
Bit 13 DISABLED 
Bit 14 DISflTHPT 
Bit 15 nSGOOME 



Request has been aborted externally. 

Request is for a segnent transfer. 

This is a request fron the diagnostic subsystem 

Target is an index relative to the SBUF Table of 

the data buffer. 

Uake caller on conplction of request. 

Blocked I/O. The caller is uaited in RTTRCHIO 

until the request is conpleted. Inplies IOURKE. 

The request has been conpleted and the caller 

auakened if he had requested (uith IOURKE). 

- Data segnent has been present and is frozen. 

- Rn error has occurred uhile flRO uas trying to 
nake the target data segnent present and freeze 
it in nenory. 

- Request is queued into disc's request queue 

• Delayed failure of SIO instruction. If a call 
to STRRTIO resulted in the request being added 
to the channel queue, this bit indicates that 
the SIO instruction failed uhen the request uas 
selected for execution. 

- The request uas aborted because of a systen 
pouer failure. 

- Request is device's current request. 

- Request is disabled. 

• Rttenpt to disable this request. 

- R nessage request reply has conpleted. 



CS 80 Integrated Cartr idge Taoe Request 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 F1NEH0NIC 

I i | I — I — I — | — I — I — I — | — I — I — I — I — I — I 

01 REQUEST OEPENDENT FLAGS (SEE BELOU) IQFLRG 

1 !"""REOUESrURG€HCY"cLflSs" jQURGCLRSS 

2 1 LOGICAL DEVICE NUflBER IQLDEV 

| I — | — | — | 1 — I — I 1 1 

3ICHRMFIRSI0PIMI RETRY |LF|SP| I URITCODE IQMSC 

4 I |"s!"" I DSt"" , (If"pR0CESS DISC I/O) IQDSCTM 

II R ' 

| | DST (IF SEGHENT TRRMSFER) (S'STRCK] I 
| .. | 1 

5 OFFSET IN THE DRTR SEG (IF PROCESS OISC I/0)|QADDR 
OR I 

| ADDRESS IN BANK (IF SEGflENT TRANSFER) I 
I 1 1 

6 1 UNIT II I FUNCTION CODE FOR IQFUNC 
| THIS REQUEST. I 
1 1 

7| ON INITIATION, SPECIFIES THE WORD COUNT (>0)IQUBCT 
I OR BYTE COUNT (<0). AT COHPLETION OF THE I 
| REQUEST THIS LOCATION CONTAINS THE ACTUAL I 
| TRANSMSSION COUNT IN THE SAHE UNITS (BYTES I 
| OR UORDS) AS IN THE REQUEST. I 

| 1 

101 P1 - PARAF1ETER 1 (USUALLY HIGH ORDER OF IQPAR1 
| CURRENT LOGICRL DISC ADDRESS [CL0A1)) I 
I 1 

11| P2 - PRRAHETER 2 (USUALLY LOU ORDER OF IQPRR2 
| CURRENT LOGICAL DISC ADDRESS [CLDR2]) I 
1 1 1 

12| PCBN I QUALIFIER I STATUS IQSTRT 
I 1 1 1 

131 SYSBASE RELATIVE INDX OF PREVIOUS REQ IN QUEUE I QPREVREQP 
I 1 

14| SYSBRSE RELATIVE INDX OF NEXT REQ IN QUEUE IQNEXTREQP 
I 1 

151 SEGIDENTIFIER (IF SEGflENT TRANSFER IQSEGIDENT 
| 1 

161 DISPLRCEP.ENT OF RERO OR URT FROfl SEG BASE (nn)IQSEGDISP 
, .. , 1 

17|S I 
|U | 
IR I 
IP I 
,__, 1 



G. 23.00 
13- 120 



QLDEV.QLDEVN - Logical Device Nunber. 

QRISC - Driver request dependent flags and counters. 



CHAN' ERR' FLG 
RSTAT' FAIL' FLG 
OPER'REQ'FLG 
Ifl» FAULT' Flfi 
RETRY 'COUNT 
LORD' FLG 
SYS'PFAIL'FLG 

URITCODE 



■ Channel error retry flag. 

• Request status failed flag. 

- Operator requested release flag. 

• Internal naintenance fault flag. 

• Retry count area. 

- nedia load flag. 

- Systen pouerfail flag. 

- Indicates type of wait: 

- Neu request. 

1 • Conplction uait. 

2 - Not ready uait. 

3 - Release/release ieny uait. 

4 • IOQ defer wait. 

5 - DSCT rtvt uait. 

6 - DSCT urite uait. 

7 • Synchronization uait. 
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QDSTN - If systen buffer is clear then this it the DST 
nunber of the target data segnent. If bit is 
set then buffer address is a D8 offset value 
instead of segnent relative offset (inplenented 
for NOURIT I/O and NOBUFF). 

QRDDR - Offset in data segnent or systen buffer table to 
target data buffer. 

QFUNC - Function code and qualifiers as specified by 
driver. 

QSTRT - PCB nunber and request conplttion status. 

PCBN - The Process Control Block (PCB) nunbtr of tht procttt 

uhich nade this request. If zero, the request is not 
associated uith any process and the IOQ elenent is to 
be returned by the systen uhen the request has conpleted. 

STATUS - General ttatua indicating tht final ttatt of tht request. 

- Not started or awaiting conplttion. 

1 - Successful conplction. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecovtrablt error has occurred. 

QUALIFIER - A code uhich further defines or qualifies the general 
status. (Sec the section Driver Return Status Codes 
earlier in this chapter.) 
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SBUF Tablt Layout 



| 

I TOTAL M 



ENTRY SIZE 



I 

|- 

| PRWRRY • 

I II1PE0ED PROCESS PCB 



ITSIZE 
-I 



I- 
-I HERD INDEX 






I- 
— I 
I I- 
I I 
I I- 
I I 
I I- 
I I 
I l~ 
I I 
I I 
I I- 
I I 
I I- 
I -> 
I II 
I II 
I II- 
I II 
I II- 
->l 

II 

II 

II- 



TRIL INDEX 



nflxinun of in use 



ITHERO 

-I 

ITTRIL 
-I 
ITUSE 



CURRENT IN USE 



OVERFLOW 



TOTAL 
REQUESTS 



INDEX OF 5 



ENTRY 1 



ENTRY 2 



I 
1 

ITOVRFL 
1 

I 

ITRQSTS 
1 

| 

1 

I 

I 

I 
1 

I 
1 

|<~ 
I I 
I I 



-I INDEX OF 1 
I 



~>| 



ENTRY 3 




INDEX OF 2 


„ _ 

ENTRY 4 
(IN USE ) 


INDEX OF 4 




ENTRY 5 

. 



I— 



I I 
I I 
I I 
I I 
I I 
I I 

I 
I 
l<— 

I I 
I I 

\" 
l< — 

I 
I 

I 
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Tablt Eltntnt Allocation (Cont.) 



Request typti 2 and 3 rtturn an indication to tht calltr if tht requttt 
could not bi tatisfitd. Tht following table specifies tht typtt of calls 
for tltntnt allocation and tht action if an tltntnt it not activattd. 



BUFFER USER 

SBUF't 

Filt tytttn 
Ptapt 
Bad track 

IOQ't 

RTTRCHIO (can bt inptdtd) 
ATTRCHIO (can bt inptdtd) 
SlOOfl (ntnory nanagtnent) 
IOntSSRGE 

HEADER DEFINITION: 



CALL TYPE 



Inptdt 
Inpede 
Print ry 



Prinary 
Inptdt 
Stcondary 
Stcondary 



FINAL ACTION 



Forget rtquttt 



Rtturn IOQX-0 



Suddtn dtath 
I/O trror 



Prinry • - Nunbtr of elenenta in tht prinary arta. 

Total • - Total nunbtr of tltntntt in tht tablt. 

Size - Sitt in uordt of tach tltntnt. 

Inptdtd PCB - If not zero thtn containt tht PCB nunbtr of tht 

firtt procttt uaiting for an tltntnt in this tablt. 
Htad indtM - Indtx of firtt frtt tltntnt. 
Tail indtM - Indtx of laat frtt tltntnt. 
In utt - Currant nunbtr not in frtt litt. 
Ovtrflout - Nunbtr of rtqutttt nadt for an tltntnt. 
Total rtqutttt - Total nunbtr of tltntntt rtquttttd. 
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T f hU Eltntnt Allocation (SBUF) 



Tht allocation of tht tltntntt in tht 100 ttnunal bufftr (TBUF) and 
tytttn bufftr (SBUF) tabltt it of conctm to tht I/O tytttn. 

Frtt Utt Of Tablt Eltntntt 

Thttt tablts art in tht torn of a frtt-linktd litt of tht frtt tltntntt. 
For tht SBUF ' s tht -1 uord of tntry is tht link to tht ntxt tltntnt. 
For the TBUF's, uord ztro it tht link and uord 1 it tht link for tht 
100 tltntntt. 

Each uord hat an 11 -uord htadtr beginning at the bast of tht tablt . Tht 
first six uords of tht htadtr 4rt for nanaging tht tablt and tht ttcond 
fivt art for nonitoring tablt activity. 

Tht tntrits follow tht htadtr at uord eleven. 



Eltntnt Allocation 

Eltntntt art obtaintd fron tht btginning of tht frtt litt, pointtd to 
by tht htad and rttumtd to tht tnd of tht frtt list pointtd by tht tail. 

Uhtn tht frtt litt it tnpty, tht htad indtx it ztro and tht tail indtx 
it ttt to point at tht htad indtx. 

Tht tablts art dividtd into tuo areas: a prinary and a secondary arta. 
Hott rtqutsts art obtaintd fron tht prinary arta. Tht secondary arta it 

ustd only for critical rtquirtntnts uhen the prinary arta is txhautttd. 
Thttt artat art logical areas dtttrnmtd by parameters m the header. 

The utility of the core resident tablet it ttrioutly reduced if their 
use is not restricted to dynamc situations. 

One of three response* nutt bt tptcifitd to tht routines which allocate 
elenentt fron tht I/O systtn tabltt: 

1. Inptdt calltr if prinary it tnpty. 

2. Gtt fron prinary Mrtt only. 

3. Gtt fron secondary arta if printry arta it tnpty. 
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Interrupt Control Stack (ICS) Fonttt 



1 2 3 4 S 6 7 t 9 10 11 12 13 14 IS 

— I — I — I — I — I — I — I — I — I — I — I — I — I — I — I — 1 

RESERVED I 



RESERVED 



RESERVED 



RESERVED 



RESERVED 



RESERVED 



RESERVED 



I 01-77 

I 01-76 

I 01-75 

I 01-74 

I 01-73 

I 01-72 

I 01-71 

I QI-70 

I 01-67 

I QI-66 

I 01-651 

I 01-64 

I— ■ 
I 01-631 

I— ■ 
I 01-621 _ _ 

I 01-61 1 CANDIDATE PIN THAT SYSTEH IS SERVICING 



RESERVED 



RESERVED 



RESERVED 



RESERVED 
RESERVED 



RESERVED 



RESERVED 



I QI-60|" C FILTER LAST TRANSACTION TIRE IWITIPUER 
| 0I-57|" PAUSE 



Tint 
HEASUREntNT INTERFACE FLAGUORD 



I- 
| 01-561 

I--I--I- 
| QI-&5IIM10I 

| BACKGROUND FILTER USED FOR 0UANTUH UPDATE 

I 01-531 BATCH FILTER USED FOR 0URNTUH UPDATE 

I 0I-52|"TfILUrToLoYfILTER CALCULATION CONSTANT 

I 01-51 | C FILTER CALCULATION DIVISOR 
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ICS 
ICS 
ICS 1 

ICS' 

ICS' 

ICE 1 

ICS' 

IICS 1 
I 



CANDPINCEU 

CUTLASTTRANUTCEU 

PAUSETinECEU. 

USTSTATECELl 
XUREFILTERCELL* 
'CUROFILTERCELL* 
'CUTOLDFILTUTCELL 

CUTDENOhXEU. 
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Interrupt Control Stack (ICS) Fornat (Cent.) 



| o 1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 

l~l--l--l--l--IH--l--l--l--l"l--M--l--l--l 
| QI-50I TWE IN CPU BEFORE PRIORITY DROP IICS'CURCFILTERCELL 

| QI-47|"~MNinin TIHE IN CPU BEFORE PRIORITY DROP IICS'JIAXCFILTERCELL* 

I qi-46 i "nfixiriunTiniiw cpu before priority orop iics'hincfiltercell* 
I 1 

I QMS I HRXWUfl PRIORITY (LOUEST VALUE) IICS'ESCHEDBASECELL* 
| UHEN ON E QUEUE I 
1 

I Qi-441 nflxinun PRIORITY (LOUEST VALUE) iiscdschedbasecell* 

I UHEN ON QUEUE I 

| QI-43I HAXinun PRIORITY (LOUEST VALUE) IICS'CSCHEOBASECELL* 

| UHEN ON C QUEUE I 

| 1 

I Qi-42| niNinun PRIORITY (HIGHEST VALUE) IICS'UORSTEPRICELL* 
I UHEN ON E QUEUE I 

I 



I Qi-41) niNinun priority (highest value) 

I UHEN ON QUEUE 

I QI-401 niNIflUn PRIORITY (HIGHEST VALUE) 
| UHEN ON C QUEUE 
|..|-| 

I 01-37 | |SU| 

,..,.-| 

| QI-361 E QUEUE PRIORITY OSCILLATION ENABLED 
I QI-351 QUEUE PRIORITY OSCILLATION ENABLED 



ICS'UORSTDPRICELL* 
ISC'UORSTCPRICELL* 



I 



I QI-341 C QUEUE PRIORITY OSCILLATION ENABLED 



I QI-331 BOUNDS CHECKING - XDS' BANK ADDRESS 

I QI-321 BOUNDS CHECKING - XDS' BASE ADDRESS 

I QI-31 | BOUNDS CHECKING - LAST VALID XDS' SEGflENT N 

| | „ | 1 1 1 

| QI-30IAHI IHODE I IBNDS 

| |..| 1 1 1 

I 0I-27| 

| 

I 01-261 

| 

I QI-251 PAUSE 



I- 
I 01-241 

I— 



TWE 
(nPE III ONLY) 



ISC'XDSEGBNKCELL[64] 
ICS'XDSEGBASECELL[64] 
ISCDSEGLMCELL164) 
ICS'PflBNDSTATCELL[64] 



I /O 
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01-45 flEASUREflENT INTERFACE Mord: 

Bit » In-notion-In Flag (in). 
1 « DISC I/O flag bit (10). 
2-15 * neaturentnt Interface Uord. 

QI-31 SinULATIONS uord: 

Bit 1 « 1 if to tnablc stack underf lou sinulations call 
by STRCKUNDERFLQU in ININ. 

QI-24 Privilege nodt Bounds Checking. 

Bit ■ Rbtolutt Hodt - DB and 06 bank not natchtd (RH). 

8-9 « Hodt fitld (nOOE). 

» if stack node - DB * txttndtd CPU rtgitttr XRR120 
and DB bank * txttndtd CPU rtgitttr XRB1200. 

■ 1 if lou cort nodt - DB<*extended CPU rtgitttr 

XRA122 and 08 bank <«extended CPU rtgxtttr XRB122. 

* 2 if xdseg nodt - DB » txttndtd CPU rtgitttr XRR121 

and DB bank « txttndtd CPU rtgitttr XR8121. 

14-15 * Bounds chtck flag (BNDS). 

* if DB, Q, and S bounds tnabltd. 

* 1 if DB bounds disabled, Q and S bounds disabltd. 

* 2 DB bounds tnabltd, Q and S bounds disabltd. 

■ 3 DB, Q, and S bounds tnabltd. 

QI- 2 Initial stack narker's P uord. 

Bit * TRACE tnabltd Flag bit (T). 

1 = logically/physically napped code segnent (L). 

2-15 * progran location value. 

QI- Initial stack narks r't Q uord. 

Bit 0*1 if ther* it a pending DSP that cannot be 
processed imediateiy (e.g., DISPATCHER 
uas PDISABLED or on the ICS). 
1-15 « (indicating n previous stack narker). 

QI* 3 Interrupt Paraneter uord. 

<1 if Extem.l Frpgran Label parameter. 
>0 if 9 p.r. bter that js passed to internal interrupt 
hanoier. 
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Interrupt Control Stack (ICS) Fornat (Cont.) 



I o 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I |--|--I"l"l"l--I"l--I"l--I"l--|--I"I"M 

| QI-23I PAUSE CODE (HPE III ONLY) 

I 1 

I QI-22I DISABLE/ENABLE DISPATCHER TO RUN COUNTER IICS'POISCNTCELL" 

| 1 

| QI-21 | RESERVED I 

| | 

j QI-20I CURRENT PROCESS STACK DST NUP.BER (FRQH PCS) IICS'STKOSTCELL 

| 1 

| QM7| PSEUDO INTERRUPT PROCESSOR'S STATUS UORD IICS'PISTATUSCELL 

| 1 

| QI-161 BASE ADDRESS OF PSEUDO INTERRUPT PROCESSOR IICS'PIDELTRPCELL 

, 1 

I QM5I 

, 

I QM4| 

| 1 

I 01-131 ABSOLUTE JOB CUTOFF TABLE ENTRY ADDRESS IICS'JCUTCELL 

| 1 

I QI-121 PCB RELATIVE ADDRESS FOR ENTRY OF CUR PROCESS I ICS' CURPCBTCELL 

| 1 

| QI-111 CURRENT PROCESS' BASE AODRESS TO ITS STACK IICS'STKBASECELL 

| 1 

| QI-101 CURRENT PROCESS' DB REL VALUE TO Z IN STACK IICS'STKDBRELZCELL" 

| 1 

01- 7| CURRENT PROCESS' DB REL VALUE TO DL IN STACK IICS'STKDBRELDLCELL" 

QI- 61 'CURRENT PROCESS' DB REL VALUE TO S IN STACK IICS'STKDBRELSCELL" 

| 1 

QI- SI CURRENT PROCESS' BANK ADDRESS TO ITS STACK IICS'STKBRNKCELL" 

| 1 

QI- 4| CURRENT PROCESS' BASE ADDRESS TO DB IN STACK IICS'ABSSTKDBCUL" 

| 1 

QI- 3| INITIAL STACK BARKER'S X REGISTER VALUE I 

QI- 2|T |L | INITIAL STACK HARKER'S P REGISTER VALUE I 
,..,.., 1 

QI- 1| INITIAL STACK BARKER'S STATUS UORO I 
,..| 1 

QI- 0|P | INITIAL STACK BARKER'S Q VALUE («0) I 
| .. | 1 

QI* 1| INITIAL STACK nARKER'S DB BANK ADDRESS | 



QI* 2| INITIAL STACK BARKER'S DB BASE ADDRESS 

QI* 3| INTERRUPT PRRABETER 
| 

* Tunable by the TUNE ceimand. 
** Knoun by tht firnuart. 
[64] Series 64 only. 
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ICS Global Cells Uith Initial Values 

ICS'RBSSTKOBCELL - Absolute address of the currently running 
process' stack. 

ICS'STKBANKCEU - Bank address for process' stack. 

ICS'STKOBRELSCELL - Stack DB relative S. 

ICS'STKDBRELDLCELL - Stack DB relative DL 

ICS'STKDBREL2CELL • Stack 08 relative Z. 

ICS'STKBASECELL - Absolute ttaek address. 

ICS* CURPCBTCELL - PCB tablt relative pointer to uord of the 
running process' Process Control Block. 

The above cells »rt to be initialized for the PROGENITOR. 

ICS'STKDSTCELL • DST nunber for running process' stack. 

ICS'JCUTCELL - The bank absolute address of the JCUT 
(Job Cutoff) Table. 

ICS'PIDELTAPCEU - PB relative address for the procedure 

PSEUDOINT (handles pstudo/soft inttrrupts) 

ICS'PISTATUSCELL - Status valut for PSEUDOINT (Z40000*CSTtt) 

ICS'PDISCNTCELL - PSDB counttr, initially 

INITIAL tttt tht abovt at described. 
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r^ M p.« C Interrupt Linkage Table (ILT) 

There it one IIT for each dtvict controller configured on the tytten. A 
controller nay aupport nore than one unit, houever the CS'80 disc driver uill 
only concern ittelf uith the tingle unit controller. 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 flNEHONIC 
MH ..|H~I--M"I»M-MH~I"M 

01 CHRNNEL IICPVAO 
11 PROGRRH IICPVA1 

2 VflRIRBLE IICPVA2 
3| RRER (ICPVA) IICPVA3 

| 1 

4 1 OUR RBORT IICPVA4 

5 1 RDORESS IICPVR5 

j ....-.-.-. ^^ 

_.| 1 1 1 1 

7|U| CHRNQUE I I CHAM | OEV IICNTRL 
| .. | 1 1 1 1 

101 SYSOB RELATIVE POINTER TO CHANNEL PROGRRH RRERIISIOP 
I 1 

111 SYSDB RELATIVE POINTER TO IDLE STATUS AREA (ISTAP 

12|"siNGL£ INSTRUCTION THAT IS EXECUTED TO EXTRACT JIUNIT 
I THE DEVICE UNIT NUHBER FROH THE STATUS POINTED 
| TO BY ISTAP. [SINCE ONLY UNIT EXISTS ON THE 
I CS'80 DISCS, ANDI IS USED TO RETURN UNIT 0] 
I — 



131 SYSDB RELATIVE OIT POINTER OF THE OEVICE 

i CURRENTLY USING THE CHANNEL TO PERFORtl A 

| OATA OPERATION. 

, 1 

14| SIOPSIZE I CQUEN 

| - 1 - 1 - 1 1 1 

15|RU|UP|IG| I HCUNIT 

l-l-l-l 1 

161 SYSDB RELATIVE DIT POINTER FOR UNIT 



17| 20 BYTES STATUS AREA FOR IDLE CHRNNEL PR0GRAI1 
, 



311 



CS'80 DISCS 
CHANNEL 
PRQGRRfl 



ICDP 



IQUEUE 
IFLBG 



IOITPO 
ISTAT 
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CHAPTER 14 SPOOLING 
Inout Oevice Directorv/Outout Device Directory 
IDD/GDD (Comon attributes referred to at XDD) 



IDD: DST * 45 (Z55) 
SIR « 3 



Overvieu of Table Structure 



ODD: DST > 46 (ZS6) 
SIR ■ 4 



| 

0| ENTRY (8 UORDS) 

21 SUBENTRY AREA POINTER 
| 

71 
, 

| HEAO ENTRIES (4 UORDS EACH) 

I 
I- 

I 



I SUBENTRIES (Z40 UORDS ERCH) 

I 



I- 



1/0 



ICPVAO - Channel Progran Variable Arta. 

The firtt uord it uted by the channel progran procettor to store ttatut 
infomation after I/O channel abortt. The next uord it uted by the driver to 
indicate if ttatut thould be tMiuntd for tpccial conditiont or errort. The 
other tuo uordt are not uted. 

ICPVR4 - DIM abort addrett. 

If a DHA abort occurt, the abtolute addrett uhere the abort occurred it 
ttored in thit area. 

ICNTRL - Containt controller infomation. 

an - If thit bit it tet, the controller it tharxng a toftuare channel 
retource in order to Unit banduidth. 

CHRNQUE - The toftuare channel retource nunber. 

CHAN - Channel nunber (four nott tignificant bitt of DRTN). 

OEV - Device nunber (three leatt tignificant bitt of DRTN). 

IQUEUE - The channel progran containt: 

SIOPSIZE - (nunber of uordt ♦ 1 )/2 in the channel progran area. 

CQUEN - or a nulti-unit controller thit field containt the toftuare 
controller retource nunber. 

IFLRG -Controller and Channel Progran ttate flagt. 

RUNURIT -Rn Idle Channel Progran thould be ttarted uhen there are no active 
requettt to proceat. 

UAITPROG -Rn Idle Channel Progran hat been ttarted for thit controller. Thit 
bit it retet by an interrupt. 

IGNOREHI -An HIOP inttruction hat been ittued againtt thit controller but the 
channel progran uas not in a uait ttatenent. Therefore, ignore 
the interrupt generated by the channel code uhen thit progran 
halta. 

HCUNIT -Highett configured unit winter for thit controller. 

ISTAT -20 bytet of ttatut fron the idle channel progran. 
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Entry fOvertll Table Definition^ 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
M ..|..|..|--l~l~M-l--l--!--l-l~M~l 

oi nftxinun size I current size io (sectors) 

1 l^ntTOENTRY SIZE « 4 | SUBENTRY SIZE « MO |1 ( UOROS ) 

2|""SUBENTRY RRER POINTER (SEGnENT RELATIVE) |2 

.-| 1 

3 00 I NEXT AVAIL DEVICE FILE 10 (OFIO) 13 
.| 1 1 

I FENCE |4 



-I- 



1 

15 
1 

16 
1 

17 
1 



DO: ■ Thit it the IDD, 
1 - Thit it the 000. 

Fence: For epooltd output dtvicet (000). the tytten-uide out- 
ftnct. For tpcoled input dtvicet (IOD), the JOBFENCE. 
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Tvoical Head Entry (4 Uords) 

12 3 4 5 6 7 8 9 10 1112 13 14 
l-l-M-M-M-M-M-M-l 
I DEVICE OUTFENCE I 
| 1 

I HERO POINTER 

| 

| TRIl POINTER 



15 
l-l 



| LOGICAL DEVICE 



I- 






Thtre art tuo types of Nad entries; a class entry and a logical device 
entry. There xs only one class entry; it is the first head entry in the 00D. 
The IOD does not have a class entry; position is filled uith zeros, fill 
spoolfiles opened by class (e.g., LP, SLOULP, EPOC, PP) *rt linked to this 
entry. There is one logical device entry for each real (physical, as opposed 
to virtual) device on the system Output devices appear in the 000, input 
devices in the IOD. RC/DC devices such as tenunals appear in both 
directories. 

Each head entry is linked to or nore subentries (a typical subentry is 
shoun in the next table). R null chain (0 subentries) consists of head 
pointer * and tail pointer « segnent- relative address of the associated 
head pointer. If one or nore subentries exists, the pointers are 
segnent-relative addresses of the first uord of the first and last subentries 
of the chain. Rny intermediate subentries are linked through the subentries. 
The tail subentry aluays contains a O-link. 

The Device OUTFENCE and LDEV* fields are neaningless for the class entry. 
For logical device entries (non-0 Logical Device field), a non-0 Device 
OUTFENCE neans that this OUTFENCE overrides the systen-uide OUTFENCE in uord 
4 of entry 0, but only for this device. 
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Note: Uords 0-Z24 are used in all subentries. Uords Z2S-Z37, 
although present in all subentries, art zero unless the 
subentry is for a speoltd filt (spoolfile). 



Uord - STRTE - 



CL 



Uord 1 - TYPE 



Uord Z22 


•10 


Uord Z23 


-FS 




M 




HERO 
INDEX 



Uord Z24 

Uord Z2S - VDEV 



Uord 226 


- VTINM 


Uord Z32 


-SQ 




RS 




FD 




SO 


RB 
Uords Z36-37 



Statt of subentry: 

• Retive 

1 * Ready 

2 ■ Open 

3 * Locked 

- 1 « Uord Z24 is a class index into the 

Device Class Tablt. 
* Uord Z24 it the LDEV associated uith 
this subentry. 

- Describes union environment created the 
subentry: 

« Session' (SPOOK) 

1 « Session 

2 « Job 

3 » Job' (SPOOK) 

• 1 • Output DFIO 
* Input DFID 

- There are ont or nore fonts ntttagt 
requests in the spoolfile. 

- The spoolfile uas created via a :MTR record 
(input spooling only). 

- The (segnent-relative eddreas)/4 of the 
head entry uith uhich this subentry is 
linked. Since head entries art four uordt 
long, this can be thought of as an index 
into the head entry portion of the XDD if 
you disallou values of and 1. 

• See description of Uord 0. 

- LPDT index of virtual device LDEV. 
Sinulates the properties of a real LDEV to 
the procets uhich FOPENs a ntu (previously 
non-exieting) file (State field (XDD(O). 
(1:2)) « 2 (Open)). 

- The volune table index of the logical 
device in date SPOOL uhtrt tht filt labtl 
(first extent) of the spoolfile lives. 

- 1 « Squeeze (purge) spoolfile txtente at 

the final copy is printed. Obsolete 
starting uith COO. 20. 
* Purge only uhtn final copy printed. 

- 1 » Restart job uhsn uarnstarting (input 

spooling only). 

- 1 * There are non-ttandard fornt on tht 

device. 

- Spaced Out bit. File Syeten could not 
acquire a ntu extent uhtn creating spoolfile. 

- This is the ISTDLIST of an aborted job. 

- Tine stanp uhcn spoolfile uas nade READY, or 
00 if not closed properly. Julian day is 

9 bits starting uith Uord Z36, bit 8. 
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Tvoical Sub»ntrv (Z40 Uords) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

| 0| I STRTE I OUTPRI |CL| 

| 1| TYPE I JOB NUHBER M 

,. , 

I 21 |Z 

| 3 1 USER NRHE I J 

i 4| « 

1 5 ! i 5 

I 7 1 ACCOUNT NRHE 1 7 

I 101 J 

1 "I I 9 

I 121 jJJ 

| 131 JOB NADE 11 

I 141 \\\ 

• 151 MS 

j ............... 

I 17| FILE NRHE MS 

I 20 1 J{ 

I 21 1 M 7 

, .. | 

| 22II0I DEVICE FILE ID M8 

| .. | .. | .. | 1 

I 23 1 FS I DA I I XDD HEAD INDEX (SEE EXPLANATION) |19 

I .. I .. J .. I J 

I 241 LOGICAL DEVICE, OR DEVICE CLASS TABLE INDEX |20 

I 1 

I 251 VIRTUAL LDEV NUHBER OF OPEN SPOOLFILE |21 

| 1 1 

| 26 1 VOLUHE TABLE INDEX | SECTOR ADDRESS 1 22 

I I I 

| 27 1 OF SPOOLFILE LABEL I 

I I 1 

I 30 1 NUHBER OF EXTENTS I 1 24 

| 1 1 

| 31| LAST EXTENT SIZE (SECTORS) 125 

1 - 1 - 1 - 1 - 1 - 1 - 1 - 1 1 

I 32ISQI IRSIFDISOIRSI I NUHBER OF COPIES 126 

I 331 SEGHENT -RELATIVE LINK TO NEXT SUBENTRY, |27 
I THIS DEVICE OR CLASS. = LAST SUBENTRY. | 
I I 

I 341 NUHBER OF RECORDS IN SPOOLFILE (DOUBLEUORD) 1 28 

- »i , r 

I 361 YERR HOD 100 I JUURN DRY OF YERR/2 |30 
| .. , ! 1 1 1 

| 37|DY| HOUR (24 MR) | HINLTE I SECONDS/4 |31 
, .. , 1 1 1 

0.23.00 
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SPOOK Taoe Fprnat 



The overall fomat of output tapes produced by the SPOOK "OUTPUT" connand is 
shoun below. The various conponents of the tape are then described in 
detail. The fomat described here is subject to change as RPE evolves. 
Rlso, there nay be errors in SPOOK uhich uould cause the actual tape fomat 
to differ f ron the one described here in sone casee. Rll numeric information 
is in integer fornat unless otherwise specified. 



EOF 



EOF 



LABEL RECORD 

EOF 

FILE OIRECTORY RECORDS 

DEVICE RNO CLASS DIRECTORY RECORD 

EOF 

SPOOLFILE 




Hechanisns for end-of-tapt and tape twitching art tht eane at for 
STORE/RESTORE taptt. 
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label Record 



Uords 0-13:1 SPOOLf ILETRPE LABEL-HP3000 

Uord 23:|""REiL»IUnBER (FIRST REEL IS NUHBER) 

Uord 24: | DATE (FROH CALENDAR INTRINSIC) 

UonJ. 25426: | TIRE (FROfl CLOCK INTRINSIC) 

Uords 30431:1 "nPEV M IF RN HPE V SPOOK TRPE 

, 

Rll other words art zero. 



Fije Pi rectory 



The File Directory hat one entry for each spoolfile on the tape. Each entry 
is 12 uords, and entries art packed into as nany 1020 uord records as needed. 
The last record uill be padded uith zeros if necessary. The entry fornat is: 



| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I |_.,.-|~|~|~|~|--|--I--|--|--I~I--IHH-- 

| Uord 0:| 0| DEVICE FILE ID NUHBER 

, ,-| 

i Uords 1-3:| 

I Uords 4-7: | USER NRht 
| 

I Uords 8-11:1 ACCOUNT NARE 



! 



I- 



* 1 File is *n output spoolfilt 
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Device and Class Pi rectory 

The Device and Class Directory is contained in one 1024-uord record. Thero 
is no EOF separating this record fron the File Directory. This directory 
contains one entry for each logical device or device class linked to the 
spoolfiles on the tape. Also, there is an entry for each logical device in 
each class in the directory, uhether or not that logical device uas directly 
referenced by a spoolfile. The entries are packed into the tape record one 
after another in no particular order. The entry fornats are ahoun belou. 



Logical Device Entry 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

M ..|.-|--|--|--|--|--|--|--I--I--|--I--IHH 

Uord 0: I LOCICRL OEVICE NUHBER I 

, 1 1 

Uord 1:1 DEVICE SUBTYPE I LENGTH OF ENTRY (3) I 

I— I 1 

Uord 2:| DEVICE TYPE I 

, 1 



w 



Device Class Entry 



, 1 

Uord 0:1 OEVICE CLASS NUHBER (NEGATED). THIS IS THE I 
| NUHBER OF THE ENTRY OF THIS DEVICE CLASS IN | 
I THE SYSTEfl'S DEVICE CLASS TABLE I 

, J 

Uord 1:1 TOTAL NUHBER OF UORDS IN THIS ENTRY I 
| 1 

Uords 2 On: I THE ENTIRE CONTENTS OF THE DEVICE CLASS I 
| TABLE ENTRY FOR THIS OEVICE CLASS I 
, 1 
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Spoolfile Fornax 



| 

I ODD ENTRY (32- UORD TRPE RECORD) 
I- 

I 



SPOOLFILE BLOCK — 
SPOOLFILE BLOCK 



TUO SPOOLFILE BLOCKS PACKED 
INTO ONE 1024-UORD TAPE RECORD 



I— 



TUO SPOOLFILE BLOCKS 
TUO SPOOLFILE BLOCKS 



The first feu spoolfile blocks have been itodified to contain user 
label information fron the spoolfile. This it explained under the 
User Labels Infomation section belou. 



Sooolfile Block Fornat 

A spoolfile block it a 512-uord block that contains variable length records 
in spooler fornat. Spoolfile records start at the first uord of the block. 
The last record is followed by a -1 to indicate that no nor* records follow. 
The last tuo words of the block contain a doubleuord which it the record 
nunber of the first record in the block. 
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User Labels Infomation 



Spoolfiles havt a nunber of uter labels uith several kinds of infomation. 
These art: 

1. Ratter: uter label 0. 

2. FOPEN entry catalog: uter libels 1-10. 

3. Circular queue for restart checkpointing: user labels 11-27. 

Since older versions of HPE did not use user labels, a uay uas needed to 
incorporate then into the SPOOK tape fornat uithout losing foruard and 
backyard conoatibility. The nethod u*»d is to add several special spoolfile 
blocks to the beginning of the spocl'ile on tape. Each of these blocks hat 
exactly one FOPEN record at its thinning. This record is folloued by a -1. 
Thus old versions of hPE uill assume that the rest of the block is garbage. 
Houevtr, the rest of the block is actually used to contain user label 
infomation. The first tuo spoolfile blocks (i.e., the first tape record of 
the spoolfile proper) ccntain or.iy the FOPEN records. The next five tape 
records actually contain user labels in addition to the FOPEN records. The 
uter labels art packed three to a spoolfile block, six to a tape record. 
Each spoolfile block of !'2 Mords has the following fornat: 



Uords 0-4: I 



Spoolfile Record Fornat 



I- 



0: j BYTE COUNT OF RECORD - 2 

l~ 
1:1 

I 

I 
I 



BYTE COUNT OF DATA PORTION OF RECORO. 
NOTE TKRT THIS COUNT INCLUDES 
TRAILING BLANKS. HOUEVER, TRAILING 
BLANKS ARE TRUNCATED IN THE ACTUAL 
RECORD, SO THIS COUNT HAY BE nORE 
THAN THE NUHBER OF BYTES ACTUALLY 
PRESENT IN THE DATA PORTION. 



Uord 2: | FUNCTION CODE: 1 • FURITE 

| 2 - FCONTROL 

| 3 • FOPEN 

i 4 • FCLOSE 

I Z100 RND BEYOND " FDEVICECONTROl 

| 

Uord 3: ! PI ~ ATTACHIO PRRARETER 



Uord 4:| P2 - ATTACHIO PRRARETER 



I- 



Uord< 5 on: I DATA PORTION OF RECORO 



I- 
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Uords Z200-Z377: 1 



I— ■ 



FOPEN RECORD 

TO TERH1NRTE THE BLOCK 

USER LABEL 



-I 



—I 



Uords Z400-Z577: | USER LK5EL 
Uords Z600-Z777: | USER LABEL 



-~™™-— , 



Following this special group cf blocks, the spoolfile resunes a nornal 
fomat. The special FOPEN records all have the nunber of user laoels in P2. 

It it often the case that tone of the 27 user labels have not been 
initialized before the tape is written. In that case, their places uill be 
filled with garbage. There is no easy uay of detecting ti-is except by 
careful inspection. 



\ 
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CHAPTER 15 UNIFIED COnnaNP UlK&UflGE (UNCI) 

P.ply Information Table (RIT) 

DST 234; SIR Z25 



1 2 3 4 5 6 7 8 91011 12 13 14 15 
|~|~I--M~I--I~I-M~I~I-M~I~I" 
0| NUHBER OF ENTRIES 
j 1 

1 | hax nurber of entries i 

2 1 "pOSITIOn"of"nEXT FREE ENTRY SPACE IN QUEUE 

3 | NUHBER OF QUEUED ENTRIES 

I 



| (52 UORDS TO HOLD PINTS OF QUEUED ENTRIES) 



I- 

| UNUSED 



0| PROCESS NUflBER (PIN) 

1 | DST« (FOR REPLY) 

2 | BUFFER RDORESS (DST RELATIVE) 

3|~~nRX~LEHGTH OF STRING I REPLY TYPE EXPECTED 

4 | DB Offitt 
, 

5 1 Ldev 
, 

6| 

I- 
7| 

I- 

I 



41 BYTES IN I1ESSRGE 



\ 

I 

I 

I 

I TRBLE 

I HERDER 

| (57 uordt) 

I 

I 

I 

I 

I 

\ 

I 

I 

I 

I 



I 

I 

I ENTRY 

| (51 uords) 

I 

I 

I 



HESSAGE IN RSCII 
(UP TO 86 CHARS.) 



I I 

I I 

I I 

I I 

I i 

I I 

I / 
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tallage, gff n9fl 

Hcssages in tht catalog cm be of eny length end can contain up to five 
paraneten. Continuation of a nenage ia indicated by "Z" or "&" at the end 
of a line. The "X" tynbol indicate! that the nonage ii continued and that a 
carriage return, line feed be inued the terninal. The "8." synbol indicate! 
that the neenge it continued on the aane line uith no carriagt return, line 
feed. 

Paraneten nay be inierted into the nenage fetched fron the catalog. The 
paraneten »n patted in the GENHESSAGE (or GENnSG) call and inierted 
uherever a "!" it found. For the tytten nenage catalog, the back tlath (\) 
it alto a paraneter, reflecting a logical device nunber. The nenage is 
routed to the uter attociated uith that logical device through the : ASSOCIATE 
connand. Hesnge tett ere indicated by "SSET n" starting in colunn 1 (the 
rtit of the line it treated at a connent). Haxinun value for n it 63. 
Connenti can be inierted in the catalog by placing "I" in colunn 1. nenage 
nunben *n poiitive integen, need not be contiguous but nust be in 
aicendmg order. After procening by the progran nftKLCAT, the catalog file 
contain! record! of 80 bytei, blocked 16, in 32 extents. (The systen nessage 
catalog ii only one extent, houever.) The fornat of the nessage catalog n 
at follow: 

•SET 1 SYSTEH HESSAGES 

1 LDEV •! IN USE BY FILE SYSTEH 

2 LDEV •• IN USE BY DIAGNOSTICS 

3 LDEV IN USE, DOWN PENDING 
5 IS "!" ON LDEV*! (Y/N)? 



t BESSAGE 35 IS TUO LINES LONG, A PARAHETER STARTS THE 
t FIRST LINE AND THE SECOND LINE IS "HP32002" 
35 !Z 
HP32002B.OO. I 



276 LDEV I FOR "!" ON ! (NUfl)! 
t 

•SET 2 CIERROR HESSRGES % 

82 STREAH FACILITY NOT ENABLED: SEE OPERATOR. (CIERR 82) 
200 HORE THAN 30 PARAHETERS TO BUILD COnnflNO. (CIERR 200) 



204 FILE COHHANO REQUIRES AT LEAST TUO PARAHETEAS, INCLUDING 

THE 

FQRflAL NAHE OF THE FILE (CIERR 204) 
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Unified Connand language 

NOTE: Process Nunber * neans entry is enpty 
Reply Type * for nunber (nun) 

* 1 for yes or no (y/n) 
« 2 for string (sxx) 

* 3 for yes, no, or nunber 

* 4 for string 
TABLE SIZE * 2046 uords 

HAX N OF ACTIVE ENTRIES * 39 
HAX N OF QUEUED ENTRIES ' 52 



HjssjflS Svsten Ge neral Description 

The nessage systen consists of the following parts: 

- Callable intrinsic GENnESSRGE 

- Uncallable procedure GENHSG uhich is used by HPE 

- Systen nessage catalog (CATALOG. PUB. SYS) and any nunber of 
user catalogs 

- Progran fWKECAT uhich builds nessage catalogs 

- HESSAGE SIR Z24 

- HESSAGE SYSGLOB CELLS Z371-373 

- HESSAGE DATA SEGflENT 

The nessage systen is used by calling GENHESSAGE (or GENHSG) uith a nessage 
nunber. The nessage systen fetches the nessage fron a nessage catalog, 
inserts paraneters, then routes the nessage to a file or returns the nessage 
in a buffer to the caller. 

A nessage catalog is a nunbered editor-type file containing sets of nettaget. 

The sets serve to break a catalog into nanageable portions. A nessage systen 
user nay call GENHESSAGE using either his oun nessage catalog or using HPE s 

catalog (CATALOG. PUB. SYS). 

After creating a nessage file, run the progran HAKECAT in order to build a 
catalog that is readable by the nessage systen. This file is still readable 
by the editor (it can be "texted") but it contains a directory (written as * 
user label). 

In order to use the nessage catalog, the progran nust first open the nessage 
catalog, then call GENHESSAGE uith the file nunber, set nunber and nessage 
nunber. (HPE users don't need to open the catalog, GENHSG autonatically uses 
CATALOG. PUB. SYS.) The file nust be opened uith the aoptions "NOBUF" and 
"n.UlU"-record access. 
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Unified Connand Language 



nRKECAT Progran 

The progran HAKECAT. PUB. SYS is used to build neesage catalogs (and also HELP 
catalogs). The progran' s input file has the fornat designator INPUT, uhich 
nuit be uted for all entry pointt. The progran hat tht following entry 
pointt: 

(no entry - Readt fron input file and buildt a tenporary file 
point) (fomal designator CATALOG). Also renanes any old 
tenporary CATALOG, CRTnn, using an archival 
nunbering tchene (i.e., CAT1, CAT2). 

BUILD • (Hutt log on under HRNAGER.SYS.) Readt fron 
input file, build the tyiten nessage catalog 
(fomal designator CATALOG), end installs the 
nessage systen. Existing catalog is rtt\»nti 
CATnnnn according to the sane schene as for no 
entry point (above). Installation of the nesnge 
systen neans noving the directory contained in 
the user label of the catalog into a data segnent. 
The DST nunber and the disc address of CATALOG 
are placed in systen global area. The nessage 
systen my be installed while the tytten it 
running. 

DIR - (nust have Pn or OP capability. ) Installs tht 
systen nessage catalog (doee not build a new 
one). Opens input file, noves the directory in 
the CATALOG into a data segnent, and places the 
DST nunber and disc address of CATALOG in systen 
global area. This nay be done when the nessage 
systen seens to be "broken" , but the catalog it 
intact. (HPE it issuing "HISSING HSG. SET'rai. 
HSG*nn" at terninalt and at the Coniolt.) This 
nay be done while the tytten it running. 

HELP - Uted to build the KELP catalog. Reade input file 
and buildt a HELP catalog (fomal dnignetor 
HELPCAT). 
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Unifitd Connand Language 



H.« M «. Svten CRTRLOG.PUB.SYS 



ISET 1 - 
•SET 2 • 
ISET 3 - 
•SET 4 • 
•SET 5 - 
ISET 6 « 
ISET 7 • 
•SET 8 • 
•SET 9 • 
•SET 10 - 
•SET 11 • 
•SET 12 • 
•SET 13 • 
•SET 14 • 
•SET 15 • 
•SET 16 • 
•SET 17 - 
•SET 18 • 
•SET 19 ■ 
•SET 20 • 
•SET 21 « 
•SET 22 - 
•SET 25 ■ 
•SET 26 • 
•SET 27 • 
•SET 28 • 
•SET 29 • 



Sytten nettaget 

CI errort and uarninga nettagee 

niacellaneout ABORT nestagtt 

Progran error abort neasagtt 

Intnntict abort nettaget 

Run-tine abort nestaget 

CI general ntssages 

File Sytten error nestaget 

Loader error netsagtt 

CRERTE error nettagee 

ACTIVATE error nettaget 

SUSPEND error nettaget 

nYCOnnRMO error nettagee 

LOCKGLORIN error neteagee 

Private Volunet error neteagee 

OS/3000 nettaget 

KELP facility error nettaget 

Graphic devicet nestaget 

Serial Oitc error nettaget 

Uter Logging error nettaget 

Rttociation Utility (ASOCTRBL) nettaget 

2680R Page Printer nettaget 

2680R Page Printer error file nettaget 

Ditc Free Space nettaget 

Sytten Internal Error ntttaget 

Ciper Device nettagee 

Store/Rettore ntttaget 



Unified Connand Language 



ngtuoi Set Directory 



- DST • in SYSGLOB Z373 

- CAT DISC ADDR in SYSGLOB Z371-372 

- Created by running HAKECAT.PUB.SYS 

- Kept in a Data Segnent and in a Uter Label 



DATA SEGflENT 



I- 
0| RAX. SET « 



1 1 It OF HESSAGE RECORDS 

2|~REC0R0 OFFSET TO FIRST nESSRGE 
| 

31 FIRST nESSRGE • 
I- 



4 | RECORD OFFSET TO FIRST HESSAGE 
| 

51 FIRST nESSRGE N 
I- 

I 



EHPTY ENTRY 



-I 

10 \ \ 
-I | HERDER 

M / 
-I 

12 \ 
-I | SET 1 

13/ 
-I 

14 \ 
-I | SET 2 

15/ 
-I 

I 



501 RECORD OFFSET TO FIRST nESSRGE 



I- 
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W Mmtw 



• Kept «t Uter Label 

• Read onto Uter't Stack 

• Utet SEARCH Intrintic Fornet 

• Variable entry tizt 



1 2 3 4 5 6 7 I 9 10 11 12 13 14 15 

I— I— I — I— I — I — I— I — I — I — I — I — I — l— I — ■ — I 

0| DIRECTORY SIZE (UOROS) I 

| 1 1 

11 ENTRY LENGTH (BYTES) I KEYUORO LENGTH (BYTES) I \ 
, 1 . j ' 

21 ENTRY I 

I KEYWORD I 



51 1 FIRST nESSRGE « 
, 

52| 

53 1 RECORD OFFSET TO CURRENT nESSRGE 
| 

54 | nESSRGE 
I BUFFER 
I (640 UORDS) 

12531 



|40\ 
-I I SET 63 

141/ 
-I 

|42\ 
-I | CUR nSG 

143/ 
-I / 

144 

I 



1683 



USER 
LABEL 



EHPTY ENTRY: 



-I 



RECORD OFFSET OF NEXT IN-USE SET | 
1 
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Unified Connand Language 



VPC P^tory 



• Extra Data Segnent 

• Built by INITUOC 



DST • in DMC255 of WWW Stack 



ENTRY 



1-255 BYTES 

I 

ENTRY RECORD • IN CICRT I I 

LEFT BYTE I RIGHT BYTE I / 

"ENTRY LENGTH (BYTES) I KEYUORD LENGTH (BYTES) I \ 
1 1 | 

ENTRY I I 

KEYUORD ~ I 

1-255 BYTES " I 

I I 
-I I 



ENTRY 



-I- 



| ENTRY REC • RIGHT BYTE I ENTRY REC • LEFT BYTE I / 



I- 



-I- 



IKEYUORO LENGTH (BYTES) I ENTRY LENGTH (BYTES) 

I ENTRY 
• KEYUORD 
" 1-255 BYTES 
I 
I- 



| ENTRY REC • 
I LEFT BYTE 
I 

I 



-I 

| RIGHT BYTE 



-I- 



"l! 

• | ENTRY 

' I 

I I 

-I I 

I I 

I / 
-I 

1 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I — I — I — I — I — I — I — I — ■ — I — I — I — I — I — i — I — I 

ILTILNINHINBI I TYPEI ENTRY SIZE 

I— I— I— I— I 1 1 

I HEADER RECORD NUHBER 

, 

I BOOY RECORD NUflBER 

| 1 

I FILE NUHBER I CCnnRNO LENGTH 

I 

I connRHD 

" NAHE 

- (1-16 BYTES) 

I 

1 

I 
! 
* ENTRIES 



I 

| LAST COnnANO ENTRY 



| LAST ENTRY (12 UORDS OF ZEROS (0)) 



I I 

I I- 

I I 



I I- 



-I 

I ENTRY SIZE-0 
-I ENDS DIRECTORY 
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LT « OPTION LIST 
LN > OPTION wOGON 
Kri « OPTION WHELP 
»6 • OPTION MOBPERK 
TYPE ■ 00 - USER uuC 

01 - ACCOUNT UDC 
10 SYSTEn UDC 
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UDCs C0nnBND.PU8.SVS 



- Record Sizt * 20(10) Uords, 6 Recorde/8Loek 

• Keeps track of uho it using uhat UDC Catalog 

- Can be purged to disable UDCs 

• Can be rebuilt to re-enable UDCt 



Z RECORD « 
| 1 

OUST FREE ENTRY • |0 
| 1 

1| MOT USED M 
| 1 

2| MX IN USE 

31 « IN USE 

4| 
I NOT USED 



12 
— I 

13 
— I 

!4 

I 



Z FREE ENTRY * 
| 1 

| NEXT FREE ENTRY ft|0 
I 1 

1| ENTRY TYPE»0 |1 
| 

2! 



1 



I 



12 



NOT USED 



I 



I I 

23! M9 

Z USER ENTRY • 

Oj CATALOG ENTRY t|0 
| 1 

1| ENTRY TYPE»1 |1 



I I 

I I 

I I 

I I 

I I 

231 |19 

| , 

Z FILE ENTRY « 
| 1 

1 NEXT CRT. ENTRY «|0 
| , 

1| ENTRY TYPE«2 |1 



G. 23.00 
15- 9 



Unified Connand Language 



UpCs COnnRND.PUB.SYS (Cont.) 



I USER* 



61 

I 

7| ACCOUNT* 
I 



101 

I 

111 

121 

I 
131 NOT USED 

I 
14| 

I 
151 

I 
161 

I 
171 

I 
201 

I 
211 

I 
221 

I 
231 

| 



12 

I 

13 

I 

14 

I 

15 
-I 

16 

I 

17 

I 

18 

I 

19 
-I 

no 

I 

111 

I 

112 
I 

113 
I 

114 
I 

115 
I 

116 
I 

117 
I 

118 
I 

119 
-I 



FILE HRHE 



4| 

I 



I 

13 

| FOPEN FORHRT: | 
|4 
I 

15 
I 

16 
I 
7 1 l/LOCKUORD) 1 7 

IS 

I 

19 

I 

o no 
i 
m 

i 

H2 
(UP TO 36 BYTES) | 
113 



61 FILE 
I 



I 
101 GROUP 

I 
111 ACCOUNT 



12 
13 



151 



22 



231 
| 



I 
|14 



115 

I 

116 



117 

I 

H8 



119 



• If the User Field and the Recount Field contain " t " . 
this indicates Sytttn Level UDCt. 

If only the User Field contains I and 7 spaces, this indicates 
Recount Level UDCs. 
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CI Stack Definition 

1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 
|.-|..|-|-|-|-|-|-|-|~|-|-|-|-|-|~| 



0B*ZO| BCOninRGE (BYTE PTR. TO CQfflUWO) 



I- 

DB+Z1 | COnnRND IRRGE 
• (280 BYTES) 



08+121 5 1 LINELENSTRCK 
I (30 UORDS) 

DB+Z253I NEXTHSG (NOT CURRENTLY USED) 

DB*Z254| (NOT USED) 

DB+Z255I 

| 

0B+Z256I 

l-l 

DB*Z257|FL| 

M-I-IH 

DB+Z260|U|LN|NH|NB| 

l-l-l-l-l-l 

DB*Z261|FE|EB|BK|NP|IR| 

l-l-l-l-l-l 

DB+Z262I IFNESTING 

I 

DB+Z263I IFSKIP 

| 

DB*Z264| ELSESEFN 



De*Z265| 






-I 

| NEST LEVEL 



-I- 



D8+Z266I 






DB«Z267| 
I- 



I— 



l-l-l- 

ISQI INR 

CONTINUE 
STRTE 
STRCK 



DB*Z270| PENCIN'«COnLEN 

0B+Z27" | BLRSTOriPRGE (BYTE PTR.) 
I 

DB«Z272| LRST CGIWRND IHPGE 
" (280 b-TES) 



UDCO 
UDC1 
UDC2 
UDC3 
UDC4 



CIFLRGS 



| 



Unified Comttnd Language 



F tiA< p«n"f^o»« 



rconirwGE" 



Byte pointer to COfllRRGE (tone tines called 
UCOMnWE) in the CI stack. 



COnnRND IHRGC • Connand character string currently being executed. 

UNELENSTRCK - R CI connand ean span up to 30 input lines. 

This stack holds the length of each input line. 



NEXTHSG 



■ Used to be ueed to link nessages together. 
No longer being used. 



UDCO - Holds the DST nunber of the UDC definitions. 

U0C1 • Holds the old S register value for UDCt. 

U0C2: (0:1) - FLUSKUDC, used by :SETCRTRLOG 

UDC3: (0:1) - OPTION LIST « 1 

(1:1) - OPTION LOGON « 1 

(2:1) - OPTION NOHELP « 1 

(3:1) - OPTION NQBRERK ■ 1 

UDC4: (0:1) • UDC Fatal CI Error 

(1:1) - UDC EXITBRERK 

(2:1) - UDC BRERKDETECTED 

(3:1) - UDC NOPRINT 

(4:1) - UDC WRGERDJUST 

(10:6) - UDC NESTLEVEL 

IFNESTING - level of nesting of :IF cotmends. 

IFSKIP - Uhether the current eomands arc being skipped 
as the false part of a : IF connand. 



ELSESEEN 



Level of the :ELSE connands. 
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CIFLRGS: (13:1)- Sequenced: line nunbers at rear. 

(15:1)— Not REOOable (last connand). 

CONTINUE STATE STRCK: History of the : CONTINUE connands: 
■ - No : CONTINUE 
» 1 - Just seen 
» 2 - In effect 

PENDINGCOnLEN - If <> 0, connand is already in stack and this 
uord is the connand string length. 

BLRSTCOninRGE • Byte pointer to last connand inage. 

LAST COnRRND WAGE - Uhen a connand conpletes execution, the connand string 
is copied here for use by the :REDO connand. 
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Association DST Layout 



MOT 
USED 



10 
M 
12 
13 
H 
IS 
16 



Unifitd Connand Unguagt 



OST Z42 



| 7 1 JHP.T INDEX 



| 101 JIT OST NUABER 



CLASS NRAE UNDER UHICH THIS LDEV IS 
flSSOCIRTEO> LEFT JUSTIFIED AND 
PADDED MITH BLANKS. 8 BYTES. 



| 11| OST REL INDEX TO USER'S NEXT ENTRY 
, 

I 121 
I 131 
I 141 
I 151 

I 

I 161 

| 

I 171 

I 

I 201 

I 

I 211 

I 221 UNOEFINEO 

I 231 

I 24| 

| 

I 



18 
-I 

19 
-I 

no 
111 

112 

113 
-I 

114 
-I 

115 
-I 

116 



117 
118 
119 
I20 
-I 



SIR 130 



ONE ENTRY/ 
SYSTEA LDEV 

\ 
I 
I 
I 
I- Ldtv 1 



(ASSOCIATED) 



I 

I 
I 
I 
I 

\ 

I 
I 
I 
I- LDEV 2 

I (UNASSOCIATED) 

I 
I 
I 

/ 



I 



I 

| JAAT INDEX OR 



I- 

| JIT OST KURBER OR 

I- 



| NEXT ENTRY POINTER OR 



| CLASSNRHE UNDER UHICH LDEV IS 
I ASSOCIATED OR UNDEFINED. 



7*n \ 



- LDEV n 
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Unifitd Connand Unguagt 



Fornatttd Cita lna Filt Structure 



l~ 



REM Ol OVERHEAD 

REM 1| 

I- CACHE DIRECTORY 

I 
I- 

reci net 

I 

I- 

I 

I 

I- 

RECADI 
I 
I- DATA 

I 
I 



AESSRGE CACHES 



1 



—I 



AC « 2 ♦ (2 * •nessage caches )/128 
D « nC ♦ (3M * Nnessage cachet )/128 

Each phytical record it one ttctor long (128 uordt). Etch etructure ttartt on 
a ttctor boundary. 
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Unifitd Connand Unguagt 

Pnalieation nessaqe Facility 

Tht Application Aessags Facility ccntittt of tuo parte: GENCAT, the catalog 
naintenance facility, and the "CAT" intnntict, through which tht netaage 
catalogt art acceettd. Tht "conpiled" catalog, uhich GENCAT createt, 
containt an extensive directory at the front of the file uhich describee 
where every nessage in the catalog it locattd. Uhen a neseage catalog it 
optntd (via CATOPEN) part of this directory it read into an extra data 
tegnent uhich is created specifically for that purpose. This "caching" of 
the directory provides nearly direct access to the desired nestagt. 

Thest nttsagtt include ntttagt ttt nunbtr, ntttage nunbere, and record 
numbers placed or "cached" into 384 uord netsage caches. The firet set 
nunber and nessage nunber of each nessage cache it placed into a cache 
directory (set and nessage nunbere nust be ascending). A nessage is found by 
scanning firet the cache directory, then the nessage ciche searching for the 
desired set end nettagt nunbtr. Tht retntvtd nessage directory entry 
contains the record nunber in the catalog file of that nessage. Nou, the 
catalog file can be read directly uting tht record nunber. 



n 



Internally, the tuo layer directory fornat it used by both the fornatted 
application nessage catalog, and the nessar — J -*- — — — ■* *-* ' 
the intrinsic CATOPEN (and used by CATREP.D 



application nessage catalog, * ftd u th « A n 5»|J'9 e txtra d ' ta »«9 n8nt created by 



The catalog filee created for AAKECAT and GENCAT nay be used uith the 
Application nessage Facility. In nost cases, applications uill increase 
their performance in nessage routing and decrease the file space uith 
fornatted catalogt. 

NLS nettaot Catalot/DST Ovtrvitu 

CACHE DIRECTORY 
| 1 

III 

! ■ I ■ ! 

, v — | I-— v — I I — V 1 

1 I AESSAGE DIRECTORIES I I 

, , , , l7TT , 

|-' I '-I I"" I '""! I'™ 1 I '~l 

|-V V V V V V V V V — I 

I DATA | DATA I DATA| DATA I DATA | OATA I DATA I DATA I OATA | 
, 1 

The ntMinun catalog eize ie 65536 tectort long. Tht largeet tet nunber it 
255. Tht largeet nettagt nunbtr it 64766, uhilt tht tnallttt ttt and ntttagt 

nunbtr it 1. 
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Cacht Directory 



Each entry in tht etcht directory it a tuo-uord entry. There exiets cnt 
etcht directory tntry for etch 384-uord netsage cacht. Tht firtt word of tht 
cacht directory entry ie the ttt mmbtr of tht firtt entry in the aetociattd 
ntssagt cacht. Tht tecond uord of the cache directory entry it tht ntttagt 
nunbtr of tht firtt tntry in tht associated nestagt cacht. 



1ST SET NUABER Of CACHE 1 
1ST ASG NUHBEA Of CACHE 1 
1ST SET NUABER OF CACHE 2 
1ST ASG NUABER OF CACHE 2 



1ST SET NUABER OF CACHE N 



H 



1ST ASG NUABER OF CACHE N 



I -CACHE DIRECTORY ENTRY 1 



<-l 

<-l 

I -CACHE OIRECTOAY ENTRY 2 
H 



<-l 

I -CACHE OIRECTOAY ENTRY N 
<-l 
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Unified Connand Language 



nutjQt Cache Fornat 



Each nessaae cache it 384 uorda long (3 records). R nessage cache entry it 3 
uordt long, 128 entries per nessage cache. Each entry contains the nessage 
nunber and set nunber of the neteage. The byte offset is the offset to the 
start of the nessage in the record specified by the record nunber. Entry 127 
is a duplicate of the first entry in the next cache. This is to allou the 
total nunber of bytes of the nessage to be conputed uithout reading the next 
nessage cache. 



nESSAGE KUrtBER 






-I- 



-I I 



< 1 



SET NUHBER I BYTE OFFSET I I -ENTRY 
1 j j 

RECORD NUHBER l<* 



nESSRGE NUHBER l< 
1 1 | j 

SET NUHBER I BYTE OFFSET | | -ENTRY 128 | 
1 | I 

RECORD NUHBER <- < 1 



I 
I 
I -CACHE 1 

I 
I 
I 



HESSRGE NUHBER 



-I- 



SET NUHBER I BYTE OFFSET 
1 

RECORD NUHBER 



HESSRGE NUHBER 



-I- 



SET NUHBER I BYTE OFFSET 
-I- 



RECORD NUHBER 



Unified Connand Language 



Data Fomat 



The fomat of the nessages is straightforward. It contains only the text of 
the nessage. It contains no comient records, nessage nunbers or set nunbers. 
fill leading and trailing blanks *rt stripped fron the nessage. 



nessaae DST (HOST) Structure 

R nessage extra data segnent is allocated during a CRTOPEN. The data segnent 
nunber is kept by the application on the return fron CRTOPEN. The fomat of 
the data segnent is sinilar of that of the fomatted nessage catalog. The 
nam difference is the addition of a table to track resident caches in the 
DST, and the catalog data is not kept in the DST. 



Hessaoe DST Overview 



| -ENTRY 
I 



I 

I 

! 

I 

I 

I -CACHE N 

I 

I 



| -ENTRY 127 | 
I I 
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| 

I 

| HOST OVERHEAD 

I 

I 

|- HOST RESIDENT CACHE AREA -| 

i 

i- 

i 



-i 

I HOST' OVERHEAD 
I 
I 
-I 
I HOST' RESIDENT' CACHE 



|- HOST CACHE DIRECTORY 
I 

| HOST RESIDENT HESSRGE I 



I 
-I 

I HOST' CACHE' DIR 
-I 
I 
-I 

IHOST'HSG'OIR 



I- 

| CACHES 

I 

| 



-I 



NOTE: A resident cache is a nessage cache copied fron the fomatted catalog. 
Resident caches are swapped in and out of the HDST and are used to detemine 
the record nunber of the desired set and nessage. 
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Unified Connand Language 



ruttiae DST Overhead 



inDST'ID 



11 
I 



I -r 
-I- 



21 SIZE OF HDST ( IN UQRDS ) 



31 CATALOG FILE NUHBER 

4| OFFSET TO RESIDENT CACHE 

SI OFFSET TO CACHE DIRECTORY 

I- 
6 

7 

10 

11 

12 

13 

14 



OFFSET TO HSG DIRECTORIES 
CACHE DIRECTORY SIZE 



HSG DIRECTORY SIZE (UOS) 
HAX NUH OF RESIDENT CACHE 
RECNUH OF FIRST HSG DIR. 
RESERVED 
RESERVED 



HOST'SIZE 
HOST' CAT 'FNUfl 
HOST' RESIDENT 'CACHE 
HDST 'CACHE' DIR 
HOST' HSG' DIR 
(UOS) nOST'CDIR'SIZC 
HOST' DIR' SIZE 
HOST* CACHE' HAN 
nDST»FIRSTDIR»RECNUB 



Unified Connand Language 

Hessaoe DST Resident Cache Area 

The Resident Cache Area it a table of the nessage directory blocks currently 
stored in the HOST, together with their index. They are held in order fron 
the nost recently accessed at the top and the oldest on the botton. The 
naxinun nunber of cachet held in the HDST at any one tine it HOST 'CACHE' RAX. 



-I 



CACHE N HOST RECENT ACCESS | HDST' RESIDENT* CRCHE 



INDEX OF CACHE DIRECTORY 
HOST RECENT ACCESS CACHE 
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HOST Cache Directory 



Each entry in the cache directory it a tuo-uord entry. There exist? one 
cache directory entry for each 384 word nessage cache. The first word of the 
cache directory entry is the set nunber of the firet entry in the associated 
nessage cache. The second uord of the cache directory entry is the r>essage 
nunber of the first entry in the associated netsage cache. 



, 1 

| 1ST SET HUHBER OF CACHE 1 |<-| 

| 1 | -CRCHE DIRECTORY ENTRY 1 

| 1ST HSG NUHBER OF CACHE 1 |<-| 

| 1 

| 1ST SET NUHBER OF CRCHE 2 |<-| 

| | l-CRCHE DIRECTORY ENTRY 2 

i 1ST HSG NUnetR OF CACHE 2 |<-| 

I I 

I I 

i: -J 

I 1ST SET NUr?ER OF CACHE N |<-| 

| | | -CACHE DIRECTORY ENTRY N 

| 1ST HSG NUnBER OF CACHE N |<-| 
, 1 
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Unifitd Cotuund Language 



nOST Wtttaqt Cacht forn»\ 

Each ntttagt eaeht it 384 uords long (3 rtcordt). A ntttagt cacht tntry it 3 
uordt long, 128 tntritt par nttaagt cacht. Each tntry contaxnt tht ntttagt 
nunfatr and stt nunbtr of tht ntttagt. Tht bytt offttt it tht offttt to tht 
ttart of tht ntttagt in tht rtcord tptcifitd by tht rtcord nunbtr. Entry 127 
it a duplicatt of tht firtt tntry in tht ntxt cacht. Thit it to allou tht 
total nunbtr of byttt of tht ntttagt to bt conputtd without rtading tht ntxt 
ntttagt cache. 



flESSAGE NUnBER 



-I 



■I 1 I 

SET NUA8ER I BYTE OFFSET I I -ENTRY 
j 1 | 

RECORD NUflBER |<- 
■I 

i 



-I 



-I 

I 



l-CRCHE 1 
I 



HESSRGE NUflBER 
-I- 



I 

I 

SET NUflBER I BYTE OFFSET I I -ENTRY 128 I 



-I- 
RECORO NUflBER 



HESSRGE NUflBER 



l<- 
-I I 



-I I 
l<- 
-I 

I 
-I 



I 
-I 



-I- 



-I 
l<- 
1 | 



SET NUnBER I BYTE OFFSET | | -ENTRY 
1 1 | 

RECORD NUnBER |<- 
1 

I 

-I 

I 

1 

HESSRGE NUflBER l<- 
1 1 | 

SET NUflBER | BYTE OFFSET | l-ENTRY 127 

RECORD NUflBER l<- < 

1 



•CACHE N 
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SYSDUflP/INITIRL 



CHAPTER 16 SYSDUflP/INITIRL 

CONFDRTR Flit 

Rtcord of CON FDRTR Filt fCTRBO) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

H-|--|~|~I--I~I~IH"I-I--IH~I-I-I 

CHECKSUfl OF CTRB (REC 0) 10 

H 



1 

2 

3 

4 

5 

6! 

7 

10 

11 

12 

13 
14 
15 

16 

1 



^ 



CURRENT VERSION OF CTR8 



STRNDRRD STRCK SIZE 
CORESIZE IN K UORDS 



TERI1INRL BOUND PRIORITY 
NORflRL PRIORITY 



CPU BOUND PRIORITY 



« OF SECONDS TO LOGON 



14 
-I 

15 
-I 

16 
-I 

17 



LOG FILE RECORD SIZE (SECTORS) 



LOG FILE SIZE (RECORDS) 



HO 



LOG BITS (ONLY 11 USED) 

<< DEFINES UHRT IS BEING LOGG€D» 






DEFAULT JOB/SESSION CPU TlflE LMIT 



111 
112 
113 
114 
115 
-I 
116 



34 1 nflxwun open spool files 
, 

35| 



— I 



I- 

36I 



I iwxinun • of spool files (kilo sectors) 



37| 

I- 

40| 



I28 

-I 

I29 



1 30 

I 

131 



| 

41| ■ SECTORS PER SPOOL EXTENT 



I- 



132 
-I 
133 
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Rtcord 1 of CONFDRTR Filt (CTRB) 

I 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
— I — I — I — t — I — I — t — I — I — I — I — I — I — I — I — 

• OF CST ENTRIES 



N OF OST ENTRIES 1 

• OF PCB ENTRIES 2 

N OF IOQ ENTRIES 3 

« OF TERfllNRL BUFFERS 4 

« OF CST EXTENSION ENTRIES 15 
INTERRUPT CONTROL STRCK SIZE (Q1 to Z1) 



1 

2 
3 
4 

5 
6 
7 
101 N BREAKPOINT ENTRIES 



N UCOP REQUEST QUEUE ENTRIES 



« TRL ENTRIES 
ft OF RINS 



13 ft GLOBAL RINS 



14 • OF SYSTEn BUFFERS 

15 « OF CONCURRENT PROGS 



16 LORDER SEGflENT SIZE 



9 

10 
11 
12 
13 
14 



I- 



24 | SIZE OF VIRTUAL nEnORY 



I- 



25 1 DIRECTORY SIZE (SECTORS) 



I- 



-I 

121 
-I 
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SYSDUflP/INITIRL 



Rtcord 1 of CONFDRTR Filt (CTRB) (Cont.) 



I- 



36| nAxinun code SEGnon sue 



I- 



37 | nAXIIUHl • OF CODE SEGflENTS/PAOCESS 



I- 



130 
-I 
131 



401 nfiXIflUn STACK SIZE (flAKDATA) 132 

41| BANinUfl EXTRA DATA SEGflENT SIZE 133 

42| HAXIflUn • Of EXTRR DATA SEGflENTS/PROCESS 134 



50 
51 

52 
53 
54 
55 
56 
57 
58 



tlAXinun A RUNNING SESSIONS 



nAXMUfl • OF RUNNING JOBS 



140 
-I 
141 



• LOGPROCS 



LOG 10' • 



N DISC REQUEST TABLE ENTRIES 
N SPECIAL REQUEST TABLE ENTRIES 



142 
1 

143 
1 

^ 144 

|45 



• PRIRARY HESSRGE TRBLE ENTRIES 

• SNAP TABLE ENTAIES 

• SECONDARY NESSAGE TABLE ENTRIES 



146 
1 

147 

148 



1 



Si 
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SYSDUJIP/INITIAL 



INITIflL/PROP PN Cennunieation DST 



Tht INITIAL/PROGEN Connunication data eegnent it used by Initial to pass 
infomation to PROG€M. This segnent is only tenporary and not nenory 
resident. 



COnnOSTM * SYSGLDBEXT (Z122) 



DST (SYSGLDBEKT (Z122)) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 IS • 

/ | POINTER TO THE START OF CTflBO 10 

| | 1 

|/ | POINTER TO THE START OF CTAB 11 

1 1 | 1 

|| | SYSTEfl START-UP OPTION 1 2 OPT 

1 1 | 1 

|| | RECOVER LOST DISC SPACE PROGRAfl 13 Recovery 

, , | 1 

|| | RESERVED I 

1 1 | 1 

\— > I CTABO ARRAY (RECORD OF THE COHFDATA FILE) |256 » X400 

| | 1 

\— >| CTAB ARRAY (RECORD 1 OF THE CONFDATA FILE) 1 256 ♦ CTABO size 
, 1 



DESCRIPTIONS 

OPT » Start-up option 

* Ua rnstart 

1 « Coolstart 

2 « Coldstart 

3 * Update 

4 • Reload 



Recovery * 1 If Recover Lost Disc Space 

* If Not Recover Lost Disc Space 



CTAB & CTABO - See the descriptions of CONFDATA 
file in this chapter. 



The Microcode uill store the CNTRL B connend into (01-11) equivalent to 
(ABS(5)-11) for the Series 37. 

CNTRL B « Start 

1 « Uamttart 

2 « Coolstart 
Z10 > Load 

Z11 « Update 
Z12 > Coldstart 
Z13 * Reload 
Z14 * Ncm 
Z20 * Dunp 

Starttype » ABS (R8S (5)-11) 
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SYSDUnP/INITIAL 



DEFDATA Table Lookup File Entry Fomat (Cont.) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

|..|.-|~|-|-|-|-|--|-|"|-|-|-|-|-l-l 
/ — 12IDEVICE CLASS NftflE LIST POINTER (ENTRY RELATIVE) 

/--13ITERMNAL DESCR. FILE NAHE POINTER (ENTRY REL.) 

/-14 



23 



DEFAULT OUTPUT DEV. OR POINTER TO DEV CLASS 



CS LDTX ENTRY POINTER (CURRENTLY SET TO 0) 



RESERVED 



DEVICE ID CODE 



RESERVED 



RESERVED 
"DEVIcTTYPf ~ | SUBTYPE |J | R| II D| SS 



-l-M-l-l-l- 



CHAN. IICRIDSISQICLIRII RECORD UIDTH 



DEFAULT TERN. 



24 



251 TERfl SPEED 



-l-l- 
TYPE |RR| 
1-|- 



RESERVED 



(ENTRY RELATIVE) 



I- 
261 RESERVED 



j 



J«Job Accepting 
A'Data Accepting 
^Interactive 
D»Duplicative 
SS«Spool State 

CR*Core Resident 
DS*DS Device 
SQsSpool Queues 
CL«Indicatcs 

whether the 

output device 

is given. 
AI'Default Ruto 

Increnent (DRT 

or Unit) 

Rft'Ruto Reply 



I- 
27| 
I- 
I 301 
I I 
I 31| 
I I 
I 321 
I " 



RESERVED 



DRIVER NRHE 



1 

I 
I 
I 
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DEFDATA Tablt Lookup File 

This file contains the default infomation for HP-supported devices. This 
file DEFDATA. PUB. SYS, is available to Syadunp and Initial and elwinates tne 
necessity for looking up default infomation every tine a device is added to 
the system. Oespite its nane, DEF0ATA.PU8.SYS in not only a file, but a 
table in the Coldload Infomation Table. It is not easily nodified. 
Therefore, it is reconnended that the file be left alone; if any user is 
unhappy uith the defaults, they can be overridden during the Sysdunp or 
Initial dialogues. 



DEFDATA Table Lookup File Header Fomat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
, H _. )HHH .. MH --|--|--|--l~|"|"l"! 

0| CHECKSUn I 



I'- 
ll VERSION 
| 

21 TOTAL TABLE SIZE IN UORDS 

31 ENTRY SIZE (SET TO 1) 
, 

4 | « OF TABLE ENTRIES 
j 



DEFDATA Table Lookup File Entry Fomat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
-I-I--I-I-I-I-I-I-I--I-I-I-I-I-I- 



DEVICE NRHE 



10 | TOTAL DEVICE ENTRY SIZE (IN UORDS) 



11 IN OF DEVICE CLASSES FOR THIS DEVICE (SET TO 1) 



I- 
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SYSDUnP/INITIAL 



DEFDATA Table Lookup File Entry Fomat (Cent.) 



II 331 
\->34 

\-> 






- TERMNAL DESCRIPTOR FILE HARE 


. 


- TERMNAL DESCRIPTOR GROUP NAflE 


" 


- TERMNAL DESCRIPTOR ACCOUNT NAftE 


- 


- OUTPUT DEVICE CLASS NRftE 


" 


\ > 


- DEVICE CLfiSS NRHE 


- 




RESERVED 



G.23.00 
16- 7 



SYSDURP/INXTIRL 



fivtrviju 



DEVDRTR.PUB.SYS 



PflRRnETER RECORD 



DRIVER TRBlf 



LPDT 
LOT 
LDTX 



CLASS/TERH HERDER 
CLASS 



I- 

| TERR DEF 

| 

I ROD' I DVR TRBLE 
I CS DEF 
I CS TRBLE 



Parantttr Record 



0| CHECKSUfl 

| 

1| VERSION 

| 

21 NEXT RECORD 



31 HIGHEST LDEV 

4 | HIGHEST DRT 
I 

51 NR. ROD 'I DRIVERS 
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SYSDUIfP/IWTIAL 



Prjvr TMl 



Tht Drivtr Tablt eontittt of 7 word tntritt, in corrttpendtnet to tht LDEV 
tntritt, up te tht tughttt LDEV uttd, tntry ttro it a durniy tntry. 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
-I— I— I— I— I— I— I— I— I— I— l—l— I— I— I— 

ORT • 
, 1 1 .-| 

1 CR| CKRN • | |DS| UNIT N 
-I 1 l"l 



RASTER LDEV 



-I- 



TYPICRL ENTRY 
FORRRT 



DS 
CR 

CHRN • 
flRSTER LDEV 



DS DEVICE (if ttt DRT it <tre) 

CORE RESIDENT 

CHANNEL • 

LDEV of dtviet uhich thit DS dtvict it linktd to. 

Uordt 3-7 contain tht drivtr nont. 



flWyW fm%\ 



CHECKSUH 

RMGO CHRNNEL PRQGRRfl 

UCS TRBLE PRT 



RHIGO 



UCS TRBLE 



UCS «1 



CHECKSUH 
RMGO 



RHIGO 



—ENTRY POINT 11 (ROH 8RSED 
HRCHINES) 



95 
127 



* Rpptar only if 
SYSUCS64 it 
prtttnt. Skipt 
to ntxt CHECKSUH 
RMGO. 
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Paramter Rteard fCont.) 



I- 



1100 1 REC * 
I- 

| LENGTH 
| 

Z102I REC N 

I- 

| LENGTH 

I 
Z104 



1 



REC N 
LENGTH 
Z106 REC « 
LENGTH 



2110 REC N 
LENGTH 



I- 



2112 REC N 
LENGTH 

Z114J REC N 
LENGTH 

X116I REC* 
LENGTH 
REC t 
LENGTH 
RECN 
LENGTH 



Z120 



Z122I 



| DVR TRBLE 
-I 
I 
1 

ILPDT 
--I 
I 
1 

I LOT 
~l 
I 
1 

ILDTK 
-I 
I 
1 

IDCTH 
-I 
I 
1 

I CLASS 



I 
-I 

ITERH DEF 
-I 



IRDO'L DVR 
-I 
I 

|CS DEF 
-I 

I 






I- 
]- 

Z200I- UNUSED 



-I 

I 

1 



|CS TABLE 



I- 
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SVSDUHP Fornat (Cont.) 






UCSN2 
UCS UN 



| CHECKSUI1 

I RHIGO 

I 

I 

RMGO 

ICS 

LOU CORE 



Only for tht 64/68. Rtftr to tht 
UCS Tablt for tht 64/68 belou. 

<— ENTRY POINT 12 (UCS BASED 
nRCHIHES) 



'———————— 127 



INITIAL CST 
CS TRBLE 





DEVICE CLASS TABLE HERDER 
DEVICE CLASS TABLE 



TERMNAL DESCRIPTOR TABLE 
TRBLE LOOKUP BUFFER 

VTPB 



01DV7RB 

CISC COLD LORD lNfORHATION TP8LE 



TABO 



CO-flUNICATION RECORO 

CSOVR 

CSDEF 



^ 
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SYSDUBP Fornat (Cont.) 



INITIAL'S 08 ARER 



STOCK BARKER 



ORIVER TABLE 



LPDT 



LDT 



LDTX 



INITIAL'S SEGBENTS 



RIN TABLE 



LOGGING IDENTIFIER TABLE 



OIRECTORV HEADER 



DIRECTORY 



EOF 



SYSTEH PROGRflnS, SL, NON-STD. DRIVERS 



EOF 



STORE/RESTORE HEADER 
EOF 



STORE/RESTORE DIRECTORY 
EOF 



USER FILES (SEPARATED BY "EOF'S" 



STORE/RESTORE TRAILER 



EOF 
EOF 
EOF 



* NOT DUBPED IF DATE * CARRIAGE RETURN 



Noti: On disc, READ-SIO-PROGRflfl kept in Disc Label. 
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Seriet 37. 37KP end 37 Bicro UCS Table Fornat 

Three entries (Entries 5, 6, end 7) used by Seriet 37, 37XP 
and 37 Bicro. 



1128 UORO | UCS 
I HERDER | 



-I 

I LUT 
I 



OJ I1ICR0C0DE VERSION (8 BYTES RSCII) 

31 

4|" t"0F UCS LOCATIONS (64 BIT UORDS) 

51 _ _ 

6| « OF LUT LOCATIONS (32 BIT UORDS) 

71 



| 

101 UCS CHECKStffl 

11| LUT CHECKSUI1 



I- 



flW V°lWf 



Store Tape Fortiat 



I EOF 



I EOF 



I 



, ----- J 



| 0| "STORE/RESTORE LflBEL-HP/3000." 
I 151 __ 

I 16| "VIIB" 

I 171 _ _ 

| 201 PARTIAL FIRST FILE FLAG 



I- 



10 
113 

— I 
114 
MS 

— I 
116 

•~ I 
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UCS Table Fernet 



I- 



N RECOROS TO UCS * 
tt RECORDS OF UCS 
ft RECORDS RFTER UCS 
UCS RECORD SIZE ON TAPE 



II 
-I 

12 
-I 

13 
-I 

14 
-I 



137 



Z4SI 
, , 1 

* If SYSUCS64 i» present, NUCS records follouing «©. 
If SYSUCS64 is not present, the preceding entry is repeated. 



Series 6x/70 UCS Table Forwat 

One entry (Entry 4) is used by Scries 64, 68, snd 70. 

1128 UORD I SLOU UCS I FAST UCS I 
I HEADER I I I 



I 0] MCROCODE VERSION (8 BYTES RSCII) 
31 



4 | « OF UCS LOCATIONS (64 BIT UORDS) 
5| _ ______ 

6 1 N OF LUT LOCATIONS (32 BIT UORDS) 

71 ....... .»„.„-,—- 

101 SLOU UCS CHECKSU11 

111 FRSTUCS ChtCKSUn 



I- 
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First Volune (Cont.) 



I 211 
I- 

I 221 
I- 

I 231 



I 241 

I- 
I 271 



CHECKSUn 



DIRECTORY INDEX OF FIRST FILE 



VOLUnE NUB8ER 



I- 
301 DATE 



TIBE 



I- 
I 31| 

I 321 _^ __ __„____ 

I 331 "tAPEBLOCKSIZE (»U0RDS/BL0CK;DEFMO96) 

I - 

I " 

I 

I 47| 



117 
-I 

118 
-I 

119 



|22 
-I 

I23 
-I 

I24 
-I 

I25 

I26 
-I 

I27 

-I 
(28 



EOF 



I 

I39 / 
-I 

I 



HERDER 
40 UOROS 



DATE: 
0:7 lest 2 digits 

of year 
7:9 Julian date 

TIBE: 

25.(0:8) hours 

(8:8) ninutes 

26.(0:8) seconds 

(8:8) .1 sees. 



| 

I FILE NRITE 
I- 



| GROUP NRRE 



RCCT. NflltE 



•I 

l\ 
-MTYP FILE 

|| ENTRY 
-IK12UDS.) 

1/ 
-I 



EOF 



FILES (SEPRRRTED BY "EOF'S") 



\ 

I 

I 

I 

I 

I VOLUlfE 

I DIRECTORY: 

I « ENTRIES 

I DETERniNED 

| BY TRPEBLOCK- 

/ SIZE 



\ 

I FILES 

I 

/ 
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SYSDUHP/INITIAL 



Subttautnt Volunts 



| Oi "STORE/RESTORE LABEL-HP/3000." 
I 15! 



"VIIB" 



161 
171 

20 1 "partial first file flag 
I 

21| CHECKSW1 

22 1 "DIRECTORY INDEX OF FIRST FILE 



13 



14 
15 



23 1 

26| 

27 1 VOLUIIE NUHBER 
I 

30 | DATE 
I- 



311 

321 

I 

I 331 

I 

I 34| 
I 471 
I- 



TIHE 



TAPE6L0CXSIZE 



16 FLAW: 
1st FILE 

17 ON THIS 
. VOL IS A 

18 PARTIAL. 

19 
22 



23 
24 



25 

26 



28 
I39 



HERDER 
40 UDS. 



I 

| FILE NAItE 



I- 

| GROUP NAHE 

I- 

I 

I- 



ACCT NfinE 



-I 

l\ 
-IITYPICAL 

II FILE 
>-|| ENTRY 

I/ 
-I 



| 

I EOF 
I 



I 

I <FILES> 

| (SEPARATED BY "EOF'S) 



/ NOTE: NO EOF. 

\ 

I 

! 

I 

I 

| VOLUHE 

I DIRECTORY 

I 

I 

I 

I 



\ 

I FILES 

I 

/ 



SYSDUHP/INITIAL 



End of Volunt 



I I 

I 
I 



<FILES> 

(SEPARATED BY EOF'S) 



| 

I EOF 



| 0|" "STORE/RESTORE LABEL-HP/3000.' 
I 151 



I 161 
I 
I 24| „„...._. 

| 25 1 "*FLAG: PRECEDING EOF HARKS FILE ENDEO 
I 26|"flAG:PRECEDING EOF HARKS TAPESET ENOED 



I- 

I 27 

I 30 

I 31 

I 32 

I 33 

I 47 
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Hiactllantous 



CHPPTF.R 17 niSCELLANEOUS 
Ubfttd Tffl SutfYt tr 

Tht HPE labtltd tapt tubsysttn ptroitt eonvtnitnt accost to ttptt labeled to 
tithtr ANSI or 1811 ttandards. It optratts ao a stt of subproctdurtt to tht 
filt tysttn. A labtltd tapt contittt of ont or rtort logical filts. Each 
logical filt contittt of thrtt physical filto, i.t., tapt artat dtlinittd by 
tapt narks. Tht first phytieal filt containo htadtr labtlt, tht stcond 
contain* tht data, and thi third contamt trailtr labtlt which art (txctpt 
for ninor difftrtnctt) copitt of tht htadtr labtlt. Tht tapt nark follouwg 
trailtr labtlt mil bt folloutd tithtr by htadtr labtlt for tht rant fill, or 
by anothtr tapt nark if thtrt it no ntxt filt. Labtlt art 80 byttt long, and 
convtntionally art idtntifitd by thtir first four characttrt (thrtt lttttrt 
and a digit) and contain infomation at follout (CP :« characttr potition; 
L:« ltngth): 

V0L1: Prtstnt only on tht firtt filt of a volunt, tht volunt labtl contains 
tht volunt idtntifitr, uhich it usually tht nunbtr on tht tapt strap, and it 
thus not txptcttd to bt changtd. 



VOLUHE NO. 



DATE 



TME 



EOF 



EOF 



EOF 



\ 

I 
I 
I FILES 

I 
I 



TRAILER 
40 UDS. 
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I CP 



I 1/3 
| 

I 4 
| 

I 5/10 

11 



i 



12/79 



FIELD NAHE 



LABEL IDENTIFIER 
LABEL NUHBER 



VOLUHE IDENTIFIER 



ACCESSIBILITY 



NOT USED 



LRBEL-STANDARO VERSION 



L I 



CONTENT 



-I 

3 I "VOL" 

1 | «T 
— -I 

6 I VOL ID 

-I- 



1 | "0" IF IBtl, ELSE " " 

62 I BLANKS 
1 

1 |T IF HP ANSI ELSE ' 



fUsctllantout 

HDR1: Firtt htadtr labtl. Rtquirtd for ttch filt and tptcifitt: 



CP I 



FIELD NAflE 



1/3 

4 

5/21 
22/27 
?8/31 



32/35 
36/39 



40/42 
43/48 



UVLn: Ustr volunt labtls. Hay bt prtstnt on tapts fron foreign thops, 
but art not untttn by HPE. If tncounttrtd, thty art igrortd. 



49/53 



LABEL IDENTIFIER 



LABEL NUHBER 



FILE IDENTIFIER 



VOLUHE SET IDENTIFIER 



REEL NUHBER 



FILE SEQUENCE NUHBER 
GENNUfl 



VERSION 



CREATION DATE 



EXPIRATION DATE 



54 | ACCESSIBILITY 
55/60 I BLOCK COUNT 



-I- 



61/73 I SYSTEH CODE 
74/80 | NOT USED 



CONTENT 



"HOR" 



FILE NAHE, IF TAPE UAS NOT 
URITTEN BY HPE, ONLY THE 
FIRST EIGHT ARE SIGNIFICANT 



NAHES THE VOLUnE ON UHICH 
THE SET OF FILES BEGINS 



COUNTS THE REELS THAT 
CONTAIN THIS FILE (1 STARTS) 



COUNTS THE FILES IN THE SET 
OF FILES (1 STARTS) 



ALUAYS "0001" 



ALUAYS "00" 



YEAR AND DAY UITHIN YEAR 
UKEN THE FILE UAS URITTEN 



-I- 



YERR AND DAY UITHIN YEAR 
UHEN THE FILE HAY BE OVER- 
URITTEH UITKOUT PERHISSIQN 



1 j X230 IF LOCKUORO, "0" V IW 
6 I NUHBER OF BLOCKS IF IW 



-I- 
13 I 

•I- 
7 I 
— I 



HP HPE 3000 ' 
BLANKS 



^ 
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HDR2: Second header label. Although defined by the standard, n»y be 
nissing on foreign tapes; it contains: 



I CP I 
I 



FIELD NflnE 



-I 1- 



|1/3| LR8EL IDENTIFIER 



| 4 | LABEL NUHBER 
| j 

| S I RECORD FORHAT 



L I 



CONTENT 



3 I 
-I- 



I 1 

I 6/10 I 



| 1 

I 11/15 I 

I 

I- 



BLOCK LENGTH 
RECORO LENGTH 



I 16/23 



I 24/36 



37 



39 
40/49 



50/51 
52/80 



LOCKUORO 



1 I 

..| 

j | T * FIXED 

| 1 | "V" * VARIABLE 

| | "U" * UNDEFINED 

| | OTHERS TREATED AS UNDEFINED 

| 5 I BLOCK LENGTH (IN CHARACTER 
| | FORHAT) 

| S I RECORD LENGTH (ADHERING TO 
I | TO HPE RULES) IN CHARACTERS 

-I 1 

I 8 



NOT USED 



RECORD TYPE 



-I- 

I 13 
-I 

I 1 

I 



CARRIAGE CONTROL 



BLKSIZE«RECSIZE? 



NOT USEO 



-I 

I 1 
I 

-I — 
I 1 

-I- 



BUFFER OFF 
NOT USEO 



HPE FILE LOCKUORO 



nPE URITES BLANKS 



"A" * ASCII 
"B" » BINARY 



"C" » CONTROL 
•' " « NO CONTROL 



YES--R" 

BLANKS 



, NO«"B" 



I 10 
-I— ■ 

I 2 
-I — . 

| 29 I BLANKS 



ALWAYS M 00 H 
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User header labels: optional. Standard prescribes UHln in tht first 
four characters, but HPE dottn't cart. 

E0V1: End of Volune; used as first trailtr label. Required if tht 
logical file is continued onto another rtel. Identical to H0R1, except 
contains the nunber of physical blocks of data in tht data arts. 



1-. 



FIELD NAH£ 



I LRBEL IDENTIFIER 



| 1. 



| LRBEL NUI18ER 



I CP 
| 

I 1/3 
| 

I 4 

I 

I 5/54 

I- 

I 

I 55/60 

| 1 

| 61/80 I SflHE AS HDR1 
, 1 



| SRHE AS H0R1 



I- 

I 

| BLOCK COUNT 



CONTENT 



"EOT 



NUHBER OF DATA BLOCKS SINCE 
LAST BEGINNING OF FILE 
SECTION LABEL GROUP 



E0V2: Defined by the standard, but nay be nissing on foreign tapes. Follows 
E0V1; fornat sane as HDR2. 

E0F1: End of File; used as first trailsr label. Requirtd if this is the end 
of the logical file. Fornat sane as E0V1. 

E0F2: Sane as E0V2 except used after E0F1. 

User trailer labels: optional. Standard prescribes UTLn in the first four 
characters, but hPE again doesn't cart. 
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IBH has a slightly different fornat uhich is: 



CP I 
-I- 



FIELD NAHE 



1/3 I LABEL IDENTIFIER 



4 | LABEL NUHBER 



-I 1- 

I L I 

-I 1- 

I 3 I 

-I 1- 



CONTENT 



-I- 



6/10 



11/15 



18/38 



RECORD FORHAT 



BLOCK LENGTH 



RECORO LENGTH 



NOT USED 



IBH POSITION 



1 I w 2" 
... | 

| "F" * FIXED 

1 | "V" * VARIRBLE 

| "U" « UNDEFINED 

| OTHERS TREATED AS UNDEFINED 

5 I BLOCK LENGTH (IN CHARACTER 
| FORHAT) 
-I- 



5 I RECORO LENGTH (ADHERING TO 
| TO HPE RULES) IN CHARACTERS 

1 | BLANK 



NOT USEO 



-I- 

39 I IBH BLOCK ATTRIBUTE 

I 

1 
— I- 



1 | "0" « NO VOLUHE SUITCH 

| "1" * A SUITCH HAS OCCURRED 
...| 

| 11 I BLANKS 
I 1 



40/80 | NOT USED 
1 



| "B" = BLOCKED RECORDS 

1 | "S" = SPANNED RECORDS 

| "R" * BLOCKED AND SPANNED 

| " " « NO BLOCKED OR SPANNED 
I 



| 41 | BLANKS 
-I 1 
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Taos Label Table 

Ths tape label table is ths private playground of the tape label eubsysttn. 
It consists of tuo parts: LDEV Control Blocks (LCBs) and Volunt Control 
Blocks (VCBs). The LDEV arta is set up at systen initialization and contains 
one entry for each nagnetic tape LDEV and ssrial disc device in the systen. 
As is connon in HPE, the first entry is a duroiy uhich tells uhert the other 
things in the table art. The volune area contains one entry for each labeled 
taps volunt requested or active on the systen. 

Although table entries srt stortd in an extra data segnsnt, they art 
generally nanipulated via local copies on tht stack. Ths procedures GETLDEV 
and GETFNUH look for LDEV and volune entries as specified; they copy then to 
stack buffers and return the DST addrtss for use in copying then back. 
POSTVTENT copies tht entries baek, and in tht case of a ntu volune entry, 
allocates space for it in tht volune ssction of the tape label table. 

Initial uill build the "uninitialized" TLT as follous: 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

H . H . H —,— 1~|~ |~ I— I— I— I— I— I— I— I— I 

SIZE Of THE TABLE, IN UORDS (ALWAYS > 1) 10 



NUHBER OF LDEVS IN THE TABLE • X 



LDEV* 



TOTAL OF LDEVS (X) ENTRIES OF ABOVE 

I 

| 

I LDEVS 

| 

I 



1 

11 

-l-l 
IT |2 

-l-l 
I 



I 



EXPANSION AREA 
DURING SETUP' TAPES 



-l-l 

IT |K* 
-l-l 
I 



T: 1 if Taps drive if not Tape drive (i.e.. teaai disc) 



G. 23.00 
17- 6 



Aiectllaneoua 

During PROGEN, SETUP' TAPES it called to initialize tht table. Tht overall 
•trueturt of tht initialized TLT it: 

TLTOST - Z32.A26 TLTSIA - Z47.I39 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



,...,..., — | — I — I — I — I— I — I — I-H-- I---I — I — I — I 



I TABLE INITIALIZATION UORD (*1 UHEN INITIALIZED) 



I ENTRY SIZE (ESIZE) * Z32.A26 



I TABLE RELATIVE POINTER TO BASE OF LCB ENTRIES (LTBASE) (1) 



I TABLE RELATIVE POINTER TO BASE OF VC6 ENTRIES (VT8ASE) (2) 



I TABLE RELATIVE POINTER TO TOP OF VOLUHE TABLE (VTTOP) (3) 



I SIZE OF TAPE LABEL TABLE, IN UOROS (VTAAX) 






NOT USED 



MO 



1 30 

I 

131 



1 



I LDEV CONTROL BLOCK RREA - ONE ENTRY/HAG TAPE ORIVE 
I 



VOLUflE CONTROL BLOCK TABLE - CONTAINS VCB ENTRIES 
AND FREE ENTRIES 



ARER AVAILABLE FOR EXPANSION OF VCB TABLE 



132 
!<-(D 



l<-(2) 



l<-(3) 




Aitcellaneeua 



Type: 00 ■ No tape nounttd 
01 « Unlabeled 

10 « ANSI 

11 * IBI1 

if file hat lockuord. 
if device it a tape drive. 

if tape it fron Burroughs, which hat incorrect block/record tize 
in the HDR2 label. Code ean be patched to correct the tize. 

HP: 1 if tape it Hewlett-Packard ANSI fornat. 

VCB eddreat: Pointer to VCB entry describing volunt nounttd on 
tape drive, only if linked. Othervitt, 0. 



L: 1 
T: 1 
B: 1 
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LCB Entry Fornat 

Tht LCB tntntt havt the follouing ttructure: 



2 3 4 



-I — I— l — l- 



| TYPE | T | L | B I HP| 

-| 1 — | — | — | — |- 

LOGICAL DEVICE NUABER 



9 10 11 12 13 14 15 
.| — | — | — | — | — | — I — I — I — I — I 



VCB AOORESS 



EXPIRATION DATE 



FILE SEQUENCE NUABER 



CREATION DATE 



BLOCK COUNT 



REEL OF FILE 



FILE NAHE 



LOCKUORD 



I- 
I 
J-, 



|4 
-I 

15 
-I 

16 

|7 
-I 

MO 
-I 

Ml 



I 
-I 
121 



VOLUHE SET IDENTIFIER 



V0LUT1E IDENTIFIER 



122 

I 

123 

I 

124 

I 

125 
-I 

126 

I 

127 

I 

130 
-I 

131 

I 

I32 

I 

I33 
-I 
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VW \«\n fv™ft 
The VCB fornat it: 



1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 
...,— i-h— |— I— I— I— I — I— I— I— I— I— I — I — I 
X | F | A | POSITION I U | SEQTYPI L6LTYPI L I A | R | B |0 

-—M l — l 1 l-l-l-l-l 

LDEV* 1 



PIN 



FILE NUABER (AFT INDEX) 



FILE SEQUENCE NUABER 
-j — | — | — |- 



-I— I- 



S | R | I C | DENSITY I U I REEL NUABER 
_|_|_|— | l—l 

EXPIRATION DATE 



1 



REEL IN VOLUAE SET 



REEL OF FILE 



FILE NARE 



no 

-I 
111 



LOCKUORD 



VOLUAE SET IDENTIFIER 



VOLUAE NAAE 



21 

22 

23 

24 

25 

26 

27 

30 

131 
I 

1 32 
I 

1 33 
-I 
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X: AH Filet Expired 

F: Flush bit - operator did REPLY <pin>,0. 

A: APPEND access 

Position: Gives htad position uithin logical filt. 

* Rt load point (LDPNT) 

1 * HDR1 label nixt (H1NX) 

3 = After H0R2 labtl (RH2) 

4 = After user header labels (RHU) 

6 * Data next (ONX) 

7 = Rfter data (RD) 

8 * E0F1/E0V1 label next (T1NX) 

10 ' After E0F2/E0V2 label (RT2) 

11 * After user trailer labels (RTU) 
U: Urite access specified. 

SeqTyp: File open sequencing type. 

* Hatch filenane 

1 « HEXT 

2 * ROOF 

3 * Use file sequence nunber 
LblTyp: Rs in LCB entry. 

L: Linkuait - nark left by CRERTETLTENT for UNKLABEL. 
n: flount uait - uaiting for operator to nount tape on FOPEN. 
R: Reel suitch uait - waiting for next reel. 
B: Busy bit - this entry is in use. 

LOEV N: Logical device nunber of tape drive with this volune, only if 
linked. Otherwise, 0. 

S: STORE tape. 

R: REELSUITCH has been done. Used by STORE/RESTORE to handle STORE 
label and directory file. 

D: Next file is direc^. Used by STORE. 

Density: volune set density. During a volune set open, contains the 

density requested by the user in FOPEN. Once the volune set is 
open, contains the actual density of the volune set. Only 
valid for tapes on variable density tape drives. 

- Default density for volune set open 

1 * 1600 6PZ 

2 * 6250 BPI 

V: 1 if volune set is being opened. Reset after conpletion of FOPEN. 

U: User logging warmstart recovery file access. (Set only during file open.) 

Volune Recognition 

Volune recognition is the responsibility of DEVREC, which reads the first 
record of a newly-nounted tape on an unowned drive and passes the record to 
RVREC. RVREC nay set: V0L1 in the firtt 4 bytes, in ASCII, in uhich ease the 
tape is ANSI; V0L1 in the first 4 bytes, in EBCDIC, in uhich case the tape is 
1811; Anything else, in uhich case the tape is considered unlabeled. 
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If an EOT reflective nark or en EOF in data is found, REELSUITCH is called 
(principally fron the file tysten procedure IOROVE) to call for the next 
reel, if any. If another rtel is needed, the tape drive is sat Unowned so 
that RVREC will be called to recognize tht new tape when it is nounted. 
REELSUITCH returns to its caller whan it is satisfied that an appropriate 
tape is nounted. 



niscellaneous 

If the tape is unlabeled, RVREC reports to DEVREC that no further action is 
required. If the tape is labeled, RVREC wants to see the first HDR1 label, 
so asks DEVREC to read another record. (Unfortunately, OEVREC cannot be 
stopped long enough for RVREC to do its own read. ) Uhen the HDR1 record is 
found, the volune entries can be searched to see if there is a pending 
request for this volune. If so, the waiting process is restarted. 

If the systen has been restarted uith tapes nounted, there will not be 
interrupts to alert DEVREC. The procedure RECOGNIZE is called when needed to 
see if any such tapes exist. 

Opening a File 

FOPEN gets into the tape label code in three different places. The first is 
to call CRERTETLTENT, uhich parses the string passed in the FORHSHSG 
paraneter to identify the labeled tape file required. If there is no 
existing corresponding entry in the volune *rt*, this is a volune set open, 
and a new volune entry is created. There nay be an existing entry (if the 
tape was FOPENed and FCLOSEd uith disposition 2 or 3), in uhich case there is 
an associated LDEV entry for the drive on uhich the tape was left nounted by 
the prior operation. In this case, the new information is stuffed into the 
existing volune entry. R bit (LINKUAIT) is left set to nark the entry for 
LINKLRBEL. 

The second entry is through LINKLRBEL, uhich is called fron RLLOCRTE. Rt 
this tine, it is necessary to identify the LDEV to be used for the tape. If 
no LDEV is associated, the LDEV entries *rt searched to see if the operator 
has already nounted the required tape. If so, the volune and LDEV entries 
trt cross-tied and LINKLRBEL is done. If the search turns up nothing 
suitable, the operator is requested to nount the appropriate tape. Then the 
procedure uaits for either a REPLY or for RVREC to discover the appearance of 
a suitable tape and restart the process. If the operator enters a reply, it 
is validated. 

The third entry is through POSITION, which is responsible for positioning the 
tape to the requested file. Rt the file, the HDR1 and KDR2 label are 
exanined as required to determine the file characteristics. 

Reading and Uritinq Files 

Rll procedures uhich nove tape go through the catchall procedure CHECKUL, 
uhich takes care of necessary labeled tape doings. The code insures that the 
sequence: header labels (including user labels), data, trailer labels 
(including user labels) is naintained. There is a separate CASE leg for each 
such procedure. 
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FCLQSE calls CHECKUL to handle writing E0F1 and E0F2. if i 
resolving the tape position. If the disposition it 3, the tape is left 
positioned at the next filt. If the disposition it 2, tht tapt is supposed 
to be left at tht btginning of tht current file, but tht codt dots not 

presently provide for rtel switching if tht present file began on a prior 
rtel. 

At present, ensuing volimtt of a nulti-volunt set mist be nounted on the sent 
drive as tht first, nottly btcaust neither tht filt systtn nor STORE/RESTORE 
was capablt of dtaling with LDEV changes in tht niddlt of a filt. REELSUITCH 
reports tht LDEV being used, houtvtr, to that tht capability of using a 
different LDEV can be addtd in tht futurt. 



S/ttf/Mwnt 



Conplicationt tntut on labeled STORE/RESTORE taptt because there netdt to bt 
a file directory at or near the beginning of each tapt of a nulti-volunc act; 
RESTORE utet this directory to date mine uhether the epecified filc(s) can 
exist on this tape. Because the retl switching process would otherwise be 
invisible to STORE/RESTORE, special bits (VCB'RSUDOKE and VCB'URITOIR) are 
kept to enable special intnnsics callable by STORE/RESTORE to report whether 
a directory needs to be written or it about to bt tncounttred. 

The special procedure NEXTTRPEFILE it used by STORE/RESTORE in lieu of doing 
a FCL0SE(,3) folloutd by an FOPEN to act to the next file. This permits 
cleaner handling of both REPLY and Forward Space (logical) File over a Reel 
switch, as well as saving tht tint needed to ttar down and reconstruct all 
tht control blocks. 



lttK?U«"l9"l 



PVOUD is used by the SKOUDEV eermand processor (in SPOOLCOTS) to obtain the 
nana of the volune on the specified drive without having to know the 
structure of the tape label table. For the sane reason, TGETINFO is used by 
the FFILEINFO intrinsic (in FILEIO) to get labeled tape infernation. 

Syst*n Failure 86 in fIPE is defined as a najor probltn in LRBSEG. Generally 
speaking it is a problen with the UT setup, for exanple if LRBSEG cannot 
find an LDEV in the table. 
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Breakpoint Table 



DST * 30(10) « 236 

The break point table it dividtd into 2 tectiont: 

1) PCB BREAKPOINT EXTENSION TABLE (PCB'BKPT'EXT) 

This table contains the heads of the breakpoint chains. 

2) BREAKPOINT ENTRY TABLE (BKPV ENTRY' TAB) 
This table contains the actual entries. 



General La r out 



FCB08) 

I I • 
l-l 



SYS GLOBAL 

14:15 
| i-j-i 

Z25 i |L|S| 
| |-H 

L s Table loeked 

S - Systen break 

points exist 



r 

I PCB'BKPT'EXT 
I 
I 
I 
-> I 

h= 1 

I I ! 

I I I 

I " 

I * 

I I ! 

I l-\-\-\-\-\-\-\-\-\-Y 

I I 

| | BKPT' ENTRY' TAB 

I I 

M~ 

|— II 
I I- 
I I 
I I 



I 

I 

1 

I 
I 



I 

I I 1 

I > I 

I I 

| 1 

I I 

I I 

I I 

I I 
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PCS Breakpoi nt E*f ntion Tablt 



| « ENTRIES 
I- 



| ENTRY SIZE * 
-I 



j HERO SYSTEM LIST I FREE ENTRY • 

"•"wEo'uSEiTenTRIES I RCTIVE ENTRY ■ Indtx lit Entry 

in breakpoint 
chain 



-I 



USER ENTRIES 



I 



Breakpoint Entry Table 



ENTRY (0) 
, 1 

0|N UOROS BREAKPOINT TRB I 
, 1 

1 | HERD FREE LIST | 

2 | * UORD USED I 

3 1 RAN • UORD USED I 

4-6 I UNUSED I 

LRST ENTRY 



FREE ENTRY 

-I 

1| SIZE 
I 

FORURRD LINK 



BRCKURRD LINN 



The bnakpoint tntry tabic contittt of vtriablt ltngth tntritt. 
Thi nininun tntry size it 7. 



nitctllantout 



Rctivt Entry 



I 



111111 
0123456789012345 
H-l-H-H-H-H-H-H-l- 
|0|P|L|V|D|F|T|U|P|C|Ul SIZE 

oi i i i i i i i mi iri 

l-l-H-l-H-H-H-H-l-H- 

1|n| UNUSED 

|- 1 

2 1 BLQCKLABEL 
3| 

, 

4 | PLOC 
| 

5 1 INSTRUCTION 



61 

I- 
7\ 

I- 

i 
I 



LINK 



USERLRBEL 



I CONDITION/COUNT 
I 



I 

I COND DESCRIPTOR 
I 



I I 
-I I 

I I 
-I / 
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Rctivf Entry (Cont.) 

ENTRY(0).(0:1) ■ FR: 
ENTRY(0).(1:1) • P: 
ENTRY(0).(2:1) • U 
ENTRY(0).(3:1) 'V: 
ENTRY(0).(4:1) « D: 

ENTRY(0).(5:1) » F: 
ENTRY(0).(6:1) • T: 
ENTRY(0).(7:1) « U: 
ENTRY(0).(8:1) - Pit: 
ENTRY(0).(9:1) « C: 
ENTRY(0).(10:1) • UP: 



ENTRY(1).(0:1) • II 
ENTRY(6) ■ LINK: 



Frtt Entry 
1 • Frtt 

> Uttd 

Priviltttd node Breakpoint 

1 « PRIV. 

« NON-PRIV 
Procttt-Loctl Breakpoint 

1 • Procttt-Loctl 

« Sytttn 
Vtlidation Bit 

1 * Inttruction In Entry(3) 

« Inttruction Not In Tab 
Doublt Trap 

1 « Brtakpoint Otcillattt Bttuttn 

P/P*1 

* Not Doublt Trap 
Ftkt , Durmy M Trap 

1 « Brtakpoint Rt P*1 

« Brtakpoint Rt P (Orig. Lee) 
Two Word Inttruction 

1 « Tuo Uord Inttruction 

« Not Tuo Uord Inttruction 
Uttr Labtl Prtttnt 

1 * Trap To Uttr Supplitd Ltbtl 

• Trap To DEBUG 
Ptrnantnt Brtakpoint 

1 « PERN 

» TEMPORARY 
Condition/Count 

1 ■ Condition/Count Sptcif itd 

• No Cond/Count 
Updating 

1 « Entry In Proettt Of Being 

Updattd/Rtnovtd 

» Not Bting updtttd/Rtnovtd 
Uttr PLRBEL hodt 
Link 

« End Of Chain 

rt>» Index NtKt Entry 



G. 23.00 
17- 16 



nitctllantout 



fletiut Entry (Cent.) 
Breakpoint Entry Tablt (Cent.) 



I- 



COUNT 



-I 



I- 



CQNDITION 



1)1 ORIGINAL CNT. | 2)1 0PERRND1 



| • OF HITS 



I- 



I 
-I 
1 I 



I- 

| 0PERRND2 

| 1 1 

|0PT1|0PT2| RE LOP 
I 1 1 



RELOP • 



(8:8) RELOP NUflBER: 

3 « LT 9 » LTE 

4 * GT 10 * GTE 

5 * EO 11 « NEO 
0PT1 -> (0:2) OPFRRNDVS TYPE 
0PT2 -> (2:2) 0PERRND2'S TYPE 

OPERRND TYPES: 

-> CONSTANT (SINGLE UORD) 

1 -> RDDRESS (DOUBLE UORD) 

3 -> INDIRECT RDDRESS (TRIPLE UORD) 

OPERAND FORNS: 
CONSTANT -> |- 



| CONST | 

ADDRESS -> I 1 1 

| REG I BASE I 

I 1 1 

| OFFSET | 

UNO. OFFSET | (TYPE 3 ONLY) 
I 1 

REG -> (0:6) CORRESPONDING INDEX INTO 'REGY'; 
3 « R 10 * DL 



4 » SY 
7 ■ DA 

5 « DX 
9 * DB 



11 » Q 

12 * S 
17 « EA 



-> (6:10) SEG V/BANK • 
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Tjn»r Rtouest List (TRL) 

The systen clock interrupt! every 100 ns. uith the CR being autonatically 
cleared. Rn exception it the Shared Clock Interface "taturtntnt "™« 
which allows rate, as fast as 5 m. The interrupt handler is the Procedure 
TICK. On entry, OB is pointing to the base of tmer request list. Besides 
tineout requests, the clock also controls tine slicing. 

I 111111 

I 0123456789012345 

I !-i-H:H:l:H:I:i-i-i-i-i-l-! 



Miscellaneous 



/0| 

I I- 

I 11 

ENTOI I- 
I 21 
I I- 
\ 31 

I- 
/4| 
I I 
I S| 
I I 

ENT1I 6 1 
I I 



NUMBER OF ENTRIES 



ENTRY SIZE (4) 



FREE UST PTR 



N OF DAYS SINCE LAST START | HP-IB SYSTEMS ONLY 



QUANTUM/100 ns 



-I 
IQTIHE 



\7 

/10 
I 

111 
ENT2I 
112 
I 
\13| 



TIME OF DAY* 
-I- 



IDTIME* 
I 



I 
US 



ENT3I 



YERR 



| JULIAN ORY 
-I- 



PTR TO HOST ACTIVE REQUEST HEAD 



TRACE UORO 



| /14|A| CODE 



EG 



| INDEX OF NEXT 



DUMMY TIME 



I I 

1 ASSIGNABLE 

TIME TO SERVICE AFTER I ENTRIES 
I REQUEST IN FRONT (UNIT- 100MS)| I 
| 1 | 

I U- 



A: if inactive request 
1 if active request 
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MPE User Logging 



MPE User Logging enables users and subsystens to log changes to data sets on 
disc or serial files. This "change" file can later be used to recover data 
lost due to a eysten or progran failure. The log file can itself be used for 
auditing purposes. 



Central Design Overview 



Harduare Environnent 



No special harduare is required to operate the systen. However, if logging 
to a tape file is desired, the harduare configuration nust include a tape 
drive. If there is no tape drive, then it nay log to a serial disc class 
device. 

Softuare Environnent 

MPE User Logging is an integral part of MPE. No other special softuare is 
required. 

Design Narrative 

User Logging enables users and subsystens to journaliie additions and 
Modifications to MPE and subsysten files. The journal can reside on either 
disc or serial log files. 

User Logging consists of a logging process, a nenory buffer, a disc resident 
logging buffer (for serial logging) and a user defined destination log file 
on disc or serial nedia. 

The logging process has tuo functions depending on uhether the destination 
file resides on disc or serial nedia. If the destination file is serial, the 
logging process perforns all output to the destir.it jo« file. If the dutira- 
tion file is on disc, the logging process allocates additional space (ex- 
tents) as it is required by the user. 

The logging buffer is divided into cennunicatien and buffer a»-eas. The eon- 
nunication area is used to pass information anong the user* and the logging 
process. This infomation includes status of the logging process and logging 
file, space renaining in the logging file and error infomation inpctant to 
users or the logging process. The buffer portion -f the looc:ng data salient 
blocks inputs into the logging file before the data is actua'ly posted. The 
buffer is flushed any tine a user requests to close a log file *»r *>*n a log- 
ging process is terminated. (The buffer is also flushed by the begin/end 
transaction or buffer flush requests). 
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Tfm,r Reguest Li »t (TRL) (Cont.) 

CODE & REQ indicate the type of request. 
CODE: REQ: TYPE: 






OITP 


Hangup 


1 


DITP 


Carrier failure 


2 


DITP 


202 turnaround 


3 


DITP 


Read 


4 


DITP 


Logon 


5 


PCBB index 
to process 


Oelay 


6 


DITP 


LP not ready 


7 


DITP 


2640 


Z10 


Port nask 


Msg port tineout 


Z11 


DITP 


Block node read 
tineout (30 sees) 


Z12 


PCBB index 


Uatehdog tiner for 




to process 


process 


Z13 


Port DST 


Port Procedure Tineout 



The list of pending requests is kept ordered by tine uith later 
entries at the tail. 



Z20-Z37 



ZS/Z6 



DITP 



*DTIHE 



SIO device tineout: 
DIT8. (codi.1 on 
expiration, cleared 
on Tinercq. 

For Series 30/33, DTIME is 
N of TICS (0.091457 ns) 
since last nidnight. 
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Error Recovery Description 

The error recovery nechanisns provided by User Logging art poutr fail 
recovery and recovery fron systen failure. 

Pouer failure recovery applies only to tape log files since MPE provides 
adequate recovery for disc files during power fail. When a pouer failure is 
detected, a nessage uill be printed on the eonsole asking the operator to 
place the tape drive back on-line. (If the operator places the tape on-line 
before the nessage valid data n»y be overwritten). (To reset the tape drive 
the operator nust hit the load button until the tension returns to the drive. 
Then hit the reset button followed by placing the tape drive back on-line.) 
At this tine the log process uill recover the file by rewinding to the load 
point and then forward spacing to the point where the power fail occurred. 
Uriting to the log file uill continue at that point. 

In the event of a systen failure, the warn start load option initiates 
recovery of User Logging files. In the ease of a serial file, the file it 
read and conpared to the disc logging buffer. Ail records found in the disc 
buffer that are not on the serial log file are posted and a proper end-of- 
file uritten. If the destination file is a disc file, all records are read 
and verified and an end-of-file posted to the file. In order to continue 
logging to a User Logging file that has been recovered in this runner, the 
lodging process for the file nuet be restarted using the console connand 
: LCG. 

NOTE: Any records in the buffer area of the legging buffer will 
be lost. 

User logging has been enhanced to work with labeled eerial 
discs. Internally the log process handles serial disc serial 
disc (or cartridge tape) log files the sane as for tape files. 
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Dtiiqn Structures 
Unr Lagging Tab It 

| ENTRY SIZE * 244 words 
OST Z33 

Table containing w tntry for each activated uttr logging process. Each 
entry it created uhen the p recti* is started, and deleted uhen the process 
teminates (via :L0G connand). The infornation is extracted fron the Logging 
Identifier Table (LIDTflB). 



Entry 



« Z 

I 1 

0| NURBER OF ENTRIES 10 
I 1 

1| FREE ENTRY HERO PT. |1 
, 1 

2 1 INUSE ENTRY HERO PT. |2 
| 1 

3 1 NEXT BUFFER NIMBER 1 3 
| 1 

4 1 HRX » PROCESSES 1 4 
| 1 

5f HRX M USERS/PROCESS I 5 
, 1 

6| 16 

| 1 

7 1 ENTRY SIZE 1 7 
| 1 

101 18 

I . I 
451 137 



U0RD ENTRIES 






NUftENTRIES 


■ 


LOGTflB 


FREE 


■ 


LOGTRBO) 


INUSE 


s 


L0GTRB(2) 


BUFNUfl 


■ 


LOGTRBO) 


HRXLOGPROC 


■ 


L0GTRB(4) 


RflX'USR'PRQC 


■ 


LOGTRB(S) 


LOCTRB'ESIZE 


s 


L0GTRB(7) 



NUHENTRIES - The nunber of entries in the logging table. 
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Typical Entrv (Cont.) 










1 14 




' 




LOCK 






UORO 











20 



24 



GROUP 



RCCT 



NUflBER OF USERS 
BUFFER OST NO 



26 



LOG STRTUS 
33 j CIS* RUTO | CURR TYPE 27 
LOGDEV 



45 



12 



16 



20 



34 LOG DEV 128 

35 LOG PCB ft 29 

36 SUITCH FLRG 30 
| 1 

37 NEU RUTO | NEU TYPE }31 

RODRESS Of 



40 

LOGGING BUFFER 
42 SIZE Of 

LOGGING BUFFER 



132 



44 FORURRO ENTRY PT 



BACKWARD ENTRY PT 



34 



1 



36 

il37 
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FREE 

INUSE 



BUFNUR 

HRXLOGPROC - 
HRX'USR'PROC - 
LOCTRB'ESIZE - 



- R table relative pointer to the first free entry 
in the logging table. (-1 ■ Table Full.) 

- R table relative pointer to the first entry in the 
the logging table that is being used. (-1 3 No Entries 
in Use.) 

• The nunber of the buffer associated with this logging 
process. Used to create the nanc of the buffer file 
if serial log file (i.e., ULOGmkmx.PUB.SYS). 

- The naxinun nunber of user logging processes allowed . 
The naxinun nunber of users per logging process. 
The size (in uords) of each entry in the table. 



| 

LOGGING 
IDENTIFIER 



10| 



BUFFER 
NHHE 



FILE 
NRHE 



~l 

10 

-I 

I 

-I 

I 

-I 

I 

1 

14 
-I 

I 
-I 

I 

-I 

I 

1 

18 
-I 

I 
-I 

I 
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TRBINDEX 
BTRBINDEX 
OTRBINOEX 

LGNRne 

BNRHE 

LFNRRE 

LFL0CKU 

LFGROUP 

LFRCCT 

NUnUSERS 

OST 

STATUS 

LGRUT0 

LGTYPE 

LGOEV 

PIN 

LGSUITCH 

LGNEURUTO 

LGNEUTYPE 

LGW0R 

BSIZE 

N£XT 

PREV 



UORO INDEX TO CURRENT ENTRY 
BYTE INDEX TO CURRENT ENTRY 
DOUBLE INDEX TO CURRENT ENTRY 

BTRBINDEX 

BTR8INDEX*8 

BTR8IN0EX*16 

BTRBINDEX*24 

BTRBINDEX*32 

BTRBINDEX440 

TRBINDEX*24 

TRBINDEX*25 

TRBINDEX+26 

TRBIKDEX*27.(0:8) 

TRBINDEX*Z7.(8:8) 

TRBINDEX*28 

TRBINDEX*29 

TRBINDEX*30 

TRBINDEXO1.(0:8) 

TRBINDEX*31.(8:8) 

DTRBINDEX*16 

DTRBINDEX*17 

TRBINDEX436 

TRBIN0EXO7 



LGNRnE - The nanc of the logging process (logging identifier). 

BNRtlE - The nanc of the disc buffer used if the logging process 

destination file is a serial file. This is a file that resides 
in PUB. SYS. The fornat of the nana ie ULOGxxkx where xxxx it 
the buffer lumber padded on the left uith zeros. 

If the switch flag is true, the following will bt the fully qualified 
file nana of the ntu log file. 

LFNRflE • The nana of the logging file. 

LFLCcMJ - T he lockuord of the disc logging file. 

LFGROuP - The group that the destination logging file resides in 
if the file is a disc file. 



<*^k 
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LFRCCT - The account that tht destination logging file resides in 
if tht filt is a disc flit. 

NUflUSERS - Tht nunber of user* currently accusing tht logging filt. 

OST - The OST nunber of tht logging data ttgnent (L0C8UFF). 
(-1 * LOGBUFF not created yet.) 

STATUS - Tht ttatus of tht logging process. 
INITIALIZING • -1 
INRCT * 
ACT « 1 
RECOVERING * 2 

LGRUTO - True if tht autonatic changelog facility uas enabled. 
(Not ueed - for future use. ) 

LGTYPE - The type of destination file of the logging process. 
OISC «0 
TAPE » 1 
SDISC » 2 
CTAPE « 3 

LGDEV - The logical dtvict nunbtr of tht disc logging filt or tht 
disc logging bufftr. 

PIN - Tht PCS nunbtr for tht logging proctss (PIN * PC8SIZE). 

LGSUITCH - Flag indicating a CHANGELOG is pending (if true). 
(Not used - for future use.) 

LGNEURUTO - True if the autonatic changelog facility uas 

requested for tht ntu log filt. (Not used - for future ust. ) 

LGNEUTYPE - If a suitch is pending, this uill bt tht typt 

of tht ntu log proctss. (-1 ■ no suitch ptnding.) 
(Not ustd - for future ust.) 

LGRODR - Stctor nunbtr of tht currtnt extent in the disc logging file or 
the disc buffer file. (Oisc buffer file has only 1 extent) 

BSIZE - The nunber of records in the current extent (for dise logging) 
or the nunber available in the disc logging buffer. 

NEXT - R table relative pointer to the next entry in the logging 
table. (-1 » this is last entry.) 

PREV - R table relative pointer to the previous entry in the logging 
table. (-1 « this is first entry) 
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Connunjcations Area 



14 



LOGGING 
I0ENT1FIER 



SUITCH FLAG 

CHANGE | NEU TYPE 

RUTO I TYPE 
1 

BUFFER DST 



4 

5 

6 

7 
10 
11 
12 RAX NUMBER OF USERS 1 10 



LOG PIN 



NUnBER OF USERS 



13 NEXT USER NUMBER 

SLEEP COUNT 
15 STRTE 
161 P.SG 



11 

"|12 
-I 

113 
-I 

1 14 



17| LOG HSG 



115 
I 1 

20| USER nSG M6 

21| LOG EfcROR |17 

| 1 

22 1 LOO DEVICE |18 

I I 

23 1 BUFFER SPACE 1 19 

1 

USED SPACE IN BUFFER |?0 

1 

FILE SET NUMBER 121 



24 
25 1 

26 



LOG 

AODRESS 
INPUT 
RECORD 



-l 

I22 
-I 
I 

"|24 
-I 

I 
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User Logging Buffer 



There uill be one of these tables around for the life of any active user log- 
ging process. The table consists of three parts: 

COnnUNICRTIONS AREA - Information about status of the process, etc. 
that is connon to all users of the process. 
Also the cells for nessages to/fron the 
process. 

USER ENTRIES - Information for a specific user of 
rua nt «»«••• fnr *w*pv u*mr of * nr 



BUFFER AREA 



Information for a specific user of the process. 
One of these for every user of a process 
(Setup by OPENLOG, reltastd by CLOSELOO). 

Bufftr ustd to hold logging records fron 
all ustre before uriting to the log file. 



I- 

I 

I 

| ENTRY N2 



COnnUNICRTIONS AREA 



ENTRY 413 



ENTRY «4 



-I 

I 

|FPT|BPT| 
-I — I — I 

|FPT|BPT| 
-I — I — I 

IFPTIBPT 
-I — I- 



ENTRY «N 



.| — |- 
|FPT|BPT 
-| — |~ 



BUFFER RRER 
4K UOROS 
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Coiwunications Area (Cont.) 



I- 



I 50 



56 1 OLD' W1T1' EXTENT |46 

S7f~~~"""""~~" 47 

| 

60 | IN USE HEAD PTR 48 



RES0URCE1 



RES0U3CE2 



I 

54| OLD UniT 
I- 



I 

61 t FREED HEAD PTR 

62 FIRST FILE 
CREATION THE 
FIRST CREATION DATE 



64 
65 

66! 



F'TYPE 
P'TYPE 
67 C'TYPE 



70 N'TYPE 



49 
50 

52 
S3 

54 

I55 
-I 
I56 






I44 
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Connunications Area (Cont.) 



I 691 



FIRST 
FILE 



157 



I 87| 



PREVIOUS 
FILE 



175 



I 1351 



I t57| 



CURRENT 
FILE 



NEXT FILE 



2011 |129 

I- -I 
I I 

I 1 

2061 REC'S IN |134 

I- -I 
I PREVIOUS FILE I 

| , 

210| F.S. ERROR I 136 

| 1 

2111 U.L. ERROR I 137 

2121 HERD PIN |138 

| , 

2131 |139 

214 | RESOURCES I 140 

I- -I 

I I 

I- -I 

I ! 

I- -I 

| 1 



93 



1111 
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LOGID 


a 


BLOGBUFF(O) 


SUITCH' 


* 


L0GBUFF(4) 


RCHANGE 


8 


L0GSUFF(5).(O:8) 


NEUTYPE 


a 


L0GBUFF(5).(8:8) 


RUTO 


s 


LOGBUFF(6).(0:8) 


LOGTYPE 


s 


L0GBUFF(6).(8:8) 


BDST 


8 


L0GBUFF(7) 


LOGPIN 


s 


L0G8UFF(8) 


NUnUSER 


s 


L0G8UFF(9) 


HAXUSER' 


s 


L0G8UFF(1O) 


USERNO 


* 


L0GBUFF(11) 


SLPCT 


s 


L0GBUFF(12) 


STATE 


s 


L0GBUFF(13) 


nsc 


a 


L0GBUFF(14) 


LOOHSG 


s 


L0G8UFF(15) 


USERHSG 


a 


L0GBUFF(16) 


LOGERR 


« 


L0GBUFF(17) 


LOGOEV 


s 


L0GBUFF(18) 


BSPRCE 


s 


L0GBUFF(19) 


BUFUSED 


8 


L0GBUFF(2O) 


VSETNO 


s 


L0GSUFF(21) 


LOGROOR 


a 


DLOGBUFF(H) 


INBUFREC 


3 


0L0GBUFF(12) 


FSIZE 


s 


DL0G6UFF(13) 


FSPRCE* 


a 


0L0GBUFF(14) 


TRECS 


■ 


DL0GBUFF(15) 


HRXF SPACE 


X 


0L0GBUFF(16) 


LRSTEXT' 


a 


L0GBUFF(34) 


EXTENT 


a 


L0GBUFF(35) 


RESOURCE 


8 


L0GBUFF(36) 


RES0URCE2 


a 


L0GBUFF(4O) 


UKERO 


a 


L0GBUFF(48) 


FHERO 


a 


L0GBUFF(49) 


FIRST' C'TIHE 


a 


0L0GBUFF(5O) 


FIRST' C'DRTE 


a 


L0GBUFF(52) 


F'TYPE 


a 


L0GBUFF(53) 


P'TYPE 


a 


L0GBUFF(54) 


C'TYPE 


a 


L0GBUFF(55) 


N'TYPE 


a 


L0GBUFF(56) 


FIRST* FILE 


a 


BL0GBUFF(S7) 


PREVIOUS' FILE 


a 


BL0GBUFF(75) 


CURRENT' FILE 


a 


BL0GBUFF(93) 


NEXT'FILE 


a 


BL0GBUFF(111) 


RECSIN'PREV 


a 


DL0G6UFF(67) 
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FSERR'CODE 

ULERR'CODE 

HERO' CKRNGE' PIN 

RESOURCES 

NOT' SAFE' TO* STOP 



LQGBUFF(136) 
L0GBUFF(137) 
L0GBUFF(138) 
L0GBUFF(14O) 
L0G8UFF(144) 



LOGIC 

SUITCH' 

CHRNGE 

NEUTYPE 

RUTO 
LOGTYPE 



BDST 

LOGPIN 

NUHUSER 

HRXUSER' 

USERNO 

SLPCT 
STATE 



HSG 



Tht nant of tht logging procttt. 

Trut if log filt suited it in progress. 

Tret if log filt nant, such that changtlog is alloutd 
(i.t., first filt in tht stt nant filtnant 001). 

If a suitch uat rtqutsttd, this uill bt tht type of tht ntu 
l&uging filt. (-1 s no auitch ponding) 
(Not ustd - for future uss.) 

Trut if tht autonatic ehangtlog option uat tptcifitd For tht 
current log filt. 

Tht typt of destination filt for tht logging procttt. 
DISC « 
TAPE * 1 
SDISC * 2 
CTRPE « 3 

The d«la stgntnt nunbtr of this tablt. 

This it tht FCB nunbtr for tht logging procttt (PIN'PCBSIZE). 

Tht nunbtr of user* currently accetsing the logging filt. 

Tht naxinun nunbtr of ustre alloutd to accttt tht logging filt. 

The next ttqutntial nunbtr to bt assigned ustre accessing tht 

•yittn. It uill get incremented for every unique 0PE**106 
and is used at tht log N in tht logging record Fornat. 

The nwbtr of users currently uaiting for activation by tht 
logging process. 

Tht s*.ate of the user loggia procttt. 
IKPCTIVE « 
ACTIVE * 1 

fin internal nessagt uord «ed to indicate an error or 
operator requett. 

6 ■ Continue processing, all is fine. 

2 - Suspk^d - error reaoing buffer file or uriting 

to serial file 

3 - Stop - stt uher issut :LOG logid.STOP sr uken an [OF 

condition is found on the disc l:g file. 
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tOGHSG - R ntttagtt fro* tht logging procttt. 

6 - Continut procttting, all is fint. 
15 - EOF - if thtre art no wore extents availablt 

to bt allocattd. 
12 - Disc space - could not allocate tht ntu extent 

because no space ltft in tht group. 
9 - Uritt trror - trror occurred uhilt uriting to 
log filt. 

USERHSG • R ntttagtt fron tht uttr procttt. 

6 - Continut procttting, all it fint. 
12 - Dite tpact - uttr process needs another txttnt 
allocattd for disc logging. 

LOGERR - Trut if trror condition during changelog. 

LOGOEV - Tht logical device nunbtr of tht current extent 
of tht ditc filt filt or tht disc bufftr filt 
(buff tr filt hat only 1 txttnt). 

BSPRCE • Tht tnount of tpact, in records, that are currently 

availablt to tht ustre. On tht latt block of tht last 
txttnt, ont record uill bt tavtd by tht logging proctss 
to that tht proper close information can be posted to the 
filt - tithtr tht trailtr record (if tht log logging 
procttt it stopped) or tht changt'to'ntu record btcaust 
of an EOF condition ;(and tht RUTO option had bttn 
tptcifitd). 

BUFUSED - Tht nunbtr of records currently in tht buffer. On all extents, 
txctpt tht latt txttnt BUFSPRCE ♦BUFUSED * 32 (nunber of records 
in a conplttt block). Houtvtr, on the last block of the last 
txttnt thit uill NOT bt trut since ont record is aluays htld in 
reserve by tN logging procttt. 

VSETNO - Thit shows tht ordtr in tht leg fill "set" of the currently 
opened log filt. 

LOGRMX - Tht ditc address of tht current txttnt of tht ditc log filt. 
If it't a atrial filt, this is tht ditc address of tht 
ditc bufftr for tht filt. (Current filt.) 

INBUFREC - Tht record nunbtr of tht ntxt block to bt uritttn to tht 

logging dtstination filt or tht dite logging bufftr for atrial 
filtt. (Ustd at an offstt into tht current extent for tht 
writes • tinct tach record it ont ttetor in ltngth). 
(Current filt.) 

FSIZE - Tht current txttnt tizt of tht logging dtstination filt or disc 
logging bufftr filt for ttrial dtstination filtt. 
(on tht latt txttnt thit uill bt tht latt txttnt size ninus D. 
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FSPACE* - The space in records that renams in the current extent of the 
disc logging destination file or disc buffer for tape 
destination files. (On the last extent of the disc log 
file, this is the anount of space mnus 1). 

TRECS - The total nunber of records untten to the logging destination 
file (including those records currently in the buffer). 
(Total records untten to all log files in the set.) 

HAXFSPACE - The total file size, in records, ninus 1. (Need that last 
record to post close inf omation. ) (Current file.) 

The extent nunber of the final extent in the disc logging 
file or disc buffer file. 



LASTEXT* 

EXTENT 

RESOURCE 



- The current extent nunber of the disc logging file or 
disc logging buffer. 

- Used for resource nanagenent (i.e., locking the buffer area 
and buffer infornation in the connunications area). 
Fornat is: 

RESOURCE ♦ * Ouner PCB nunber 
RESOURCE ♦ 1 s Head of inpeded queue PCB nunber 
RESOURCE ♦ 2 * Tail of inpeded queue PCB nunber 
RESOURCE ♦ 3 » Queue length 

RES0URCE2 - Use for locking file infornation and nessages in the 
connunications *rt*. 

OLD* LIHIT - The nunber of records in the last disc log file. 

OLD'hWEXTENT-The nunber of extents in the last disc log file. 

UHEAD - " table relative pointer to the first entry into the logging 
data segnent. (-1 * no entries currently in use) 



- R table relative pointer to the first free entry in the logging 
data segnent. (-1 * no free entries) 



FKERO 

FIRST' C'TME-First file creation tine, 
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Typical Loohuff Entry 



| 

0| 
I- 

I USER 
I- 

| NAht 
I- 
I 
| 

4| 
I- 

GROUP 



NAHE 



-I 
10 
-I 

I 
-I 



10 



- ACCOUNT 

- NAF1E 



14| USER PCB « H2 
OPENLOG COUNT |13 
UAIT STATE 



15 
16 
17 
20 
21 
22 



ERROR COOE 
LOG NUHBER 
SUBSYSTEH COOE 
TOTAL 
RECOROS 



14 
15 
16 
17 
18 



27 j FRUO ENTRY PTR I 23 
| 1 

30 1 BKURD ENTRY PTR 1 24 
, 1 
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lUtcellaneout 



fUscellanecus 

FIRSrC'DATE-Firest file creation date. 

F'TYPE - First log file type. 

P'TYPE • Previous log file type. 

C'TYPE - Current log file type. 

N'TYPE - Next log file type. 

FIRST' FILE - First log file in the log sequence. 

PREVIOUS* FIE-Previous log file in the log sequence. 

CURRENT' FILE -Current log file in the log sequence. 

NEXT'FILE - Next log file in the log sequence. 

RECS'IN'PREV- Total nunber of records in all of the previous file in 
the log file set. 

FSERR'COOE - File systen error encountered upon changelog. 

ULERR'COOE - User logging error encountered upon changelog. 

HEAD' CHANGE* PIN-PCB index of process uaiting for : CHANGELOG connand to 
flush. Note only one process uaiting at a tine. 

RES0URCE3 - Use for locking user entry *n» and pointer infornation 
about the user entries in the connunications irt*. 

NOrSRFE'TO'STQP-If it is set, then do not process the Stoplog until 
cxchangelog resets the bit. 
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(tisccllaneous 



BINDEX 
INOEX 
DINOEX 

USER 
GROUP 
RCCT 

UPIN 

OPENCNT 

USTATE 

ERROR 

LGNUH 

SCODE 

RECS 

NENTRY 
PENTRY 



BYTE INOEX TO CURRENT ENTRY 
UORD INDEX TO CURRENT ENTRY 
DOUBLE INDEX TO CURRENT ENTRY 

BINDEX 

BIKDEX+8 

BINOEX+16 

INDEX+12 
1N0EX*13 
INOEX+14 
INCE V *15 
INDEXt16 
INDEX* 17 

DINDEX*9 



INDEXES 
INCEX424 

USER - The ntnt of the user uho opened the logging file 
through this entry. 

GROUP - The group of the user uho opened the logging file. 

RCCT - The account of the user uho opened the logging file. 

UPIN - The PCB nunber of the user process (PIN * PCBSIZE). 

OPENCNT - Counter of hou nany tines this user called OPENLOG. 

(Increnented for every OPENLOG, decrenented for every 
CLG3EL0G). 

USTATE - The uait status of the users process. 
INACTIVE « 
ACTIVE ■ 1 

ERROR - Used to hold error infornation for this user. 

-1 = No roon in disc (or disc buffer) ard NOUAIT. 
* OK. 

LGNUn - The loosing nunber assigned to the user. (Fron USERNO in 
global* area to be used as log » in the log record). 

SCODE - The subsysten code for the caller. This applies only to 
privileged callers. 

RECS - The nunber of records untten by t*us user. 

NENTRY - A table relati.e pointer to the next er.*.ry in f.e 
logging data segnent. (-1 " this is *>.e lafct entry) 

PENTRY - 5 tilie rtlitive pointer to the previou? e"try in the 
log='-.a data sejier.t. (-1 * this is the first entr.) 
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Riscellaneous 



Uttr Logging Identifier Table 



| ENTRY SIZE ' 
DST Z41 



Table containing an intry for each potential logging preeeet. Entriet 
added via : GET LOG and released via :RELL0G. 



Entry WO 



II Z 

0| lo 

I 1 

llrtflX NUflBER OF ENTRIESM 
, 1 

21 |2 

f.:::::::::::::::> 

4 1 ENTRY SIZE |4 

i — : 1 

I . I 

40| I32 



ENTRIES 



GENTRIES 
ENTRYSIZE 



LIOTRB(I) 
LI0TflB(4) 



RENTRIES - The naxinun nuitber of entries in the table 

(i.e., naxinun nunber of user logging processes; 
1 entry for every process - activated or not). 

ENTRYSIZE - The site of each entry in the table. 
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hiecellaneous 



Typical Entry (Cont.) 



I— 



301 
|- 



| USER'S 

I- 

I NRHE 

I- 

I 

| 



34| 



I- 

I USER'S 

I ACCOUNT 



I 

401 LOG TYPE 
| 



24 



28 



BYTE ENTRIES 

LID « 

PU « 

FNRnE' 

LU « 

FGROUP 

FRCCT 

UNfiflE * 

URCCT 

UORD ENTRIES 

TYP 



BLIOTRB 

BLIGTRB(8) 

BLICTSB(16) 

BLI0TRB(24) 

6l™TRB(32) 

8lIDTRB(40) 

eUDTR8(48) 

?UDTR8(56) 



LIDTRB(32) 



PU 



- Thp logging identifier natte. This is a naxinun of eight 
characters long. 

- The pass uoro for t fc e logging identifier. This ie a 
nannun of e*ght characters long. 

The foilcaing is the fully qualified file nane of the current log file: 

FNRnE* - The r.int of the destination file. 

LU - W lockuord on the destination file if the file is on disc. 

FGROUP - The group that the file resides in. 

FRCCT - The account that the destination file resides in. 
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lUscellaneous 
Tvoical Entry 
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niscellaneous 

UNfiflE 
USCCT 



The na«e of the user uho created the logging identifier. 

The account of the user uho created the logging identifier. 

The status of the entry. 

(0:1) ■ ftuto changelog alloued 
(1:1) • No Ruto on :GETLOG, :RLTLOG 
(2:7) * Previous type 
(9:7) » Neu type 

* Disc log file 

1 « Tape log file 

2 * Serial disc log file 

3 ■ Cartridge tape log file 



Logging Record Fornat 

RECORD SIZE " 128 words 
USER RRER > 119 words 



LOG RECORD RT QPENLOG 



2 



127 



-I 1- 



6 7 11 12 24 25 

-I — I I — i — ! — ! 1 

I I I I I I II 
RECNICKSUniCODE |TME|DflTE| LOGIDlLOGM CRERTOR'PCB I I 

| 1 1 1 1 1 | 1 1 1 1 



USER OR SUBSYSTEH/CONTINURTION LOG RECORD (fron URITELGG) 



2 3 
| j j 



4 6 7 



8. 9 

j r i i i i 

j REttlCKSUfllCODE |TinE|DRTE|LOGN|LEh| 



127 



USER RRER 






LOG RECORD RT CLOSELOG 
2 3 4 6 



-I- 



-I- 



-I 1 1- 



11 12 

— I— - 1- 



n 25 

— I— -I- 



127 
1 



j I I I I I I I lj I 

| RECWlCKSUniCODE |TWE|DRTE| LOGID|LOG«| CREATOR I PCB I I 



CRRSN KRRKEft 










2 3 

1 1 1- 


4 


6 7 
-1 1 





127 


1 1 1 


1 


1 1 
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Riscellaneous 



I RECNlCKSlffllCOOE I TIRE I DATE I 
,. , 1- 1 1 1- 



HERDER RECORD (START/RESTART) 
2 3 4 6 7 



-I- 



-I- 



-I 1 1- 



-I- 



i i i i i i i 

I RECttlCKSUniCODE I TIRE I DATE I LOGID I 
| , 1 1 1 1 1 - 



TRAILER RECORD (STOP) 
2 3 4 6 



11 

— I- 



, 1 1 1 1 |- 

I I I I I I I 

I RECttlCKSUMCODE ITIREIDRTEI LOGID I 

NULL RECORD 



127 



-I 1- 



6 

— I- 



2 

I— I i i . i 

| RECttlCKSUniCODE |TinE|DRTE| 
| 1 , |— -|~ -| 



127 



Riscellaneous 



I I I I I I I 
| REM I CKSUfl | COOE I TIRE I DATE I LOGID I 
| ,. 1- 1 1 1 1- 



CHANGELOG RECORD (Cent.) 

11 12 14 15 33 34 52 53 72 127 

I 1 1 1 1 1 1 1 — 

\ III I I I I I I I 

/ SEQ|C-TIRE|C-DATE|F-FILE|F-TYPE|P-FILE|P-TYPE|C-FIL£|C-TYPEI I 
| 1 j 1 | 1 | 1 1 1 — | 

Note: If CODE * 12, P-Filt « Previous file in eet. 
If CODE * 13, P-FILE » Next filt in tit. 



BEGIN TRRNSRCTION RARKER 
2 3 4 6 7 



-I- 



-I- 



8 9 



-I 1 1 1— I — 



127 



i j i i i i i i 

I REC** l CKSUn | CODE I TIRE I DATE I LOG* I LEN I 
, 1 1 1 1 1 1~|- 



USER RRER 



ENO TRRNSRCTION RARKER 
2 3 4 6 7 



I- 



-I- 



-|- 



-I- 



9 



-I 1 1 — I- 



127 



I I I I I I I I 
I RECNICKSUniCOOE I TIRE I DATE I LOG* I LEN | 
| 1 1 1 ) 1 1~|- 



USER RRER 



1 



CHRNGCLOG RECORD 
2 3 4 



., 1 , 1- 
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CODE DEFINITION 


CODE. (8:8) * 


1 


Open I09 record 


2 


User/subsysten record (URITELOG) 


3 


Close log record 


4 


Header record 


5 


Trailer record 


6 


Restart record 


7 


Continuation of a user or subsysten record 


9 


Crash mrktr 


10 


End transaction record 


11 


Begin transaction record 


12 


Changelog record in neu file 


13 


Changelog record in old file 


SPACE 


NULL record 
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niscellaneout 



DRTR FIELDS Of LOG RECORDS 



RECf 


■ 


DOUBLE INTEGER 


CKSun 


• 


INTEGER 


CODE 


s 


INTEGER 


TWE 


a 


DOUBLE (freti intrinsic CLOCK) 


DRTE 


8 


INTEGER (fron intrinsic CALENDAR) 


LOGID 


a 


RSCII 


LOG* 


a 


INTEGER 


LEN 


a 


INTEGER 


USERRRER 


a 


RSCII 


CREATOR 


a 


ASCII 


PCB 


a 


INTEGER 


C-DATE 


a 


INTEGER 


C-TIRE 


a 


DOUBLE 


F-FILE-NARE 


a 


RSCII 


P-FILE-NARE 


a 


ASCII 


C-FILE-NRI1E 


a 


ASCII 


F-TYPE 


a 


INTEGER 


P-TYPE 


a 


INTEGER 


C-TYPE 


a 


INTEGER 


SEQ 


a 


INTEGER 



NOTE: 

1. The checktun algorithn usee the exclusive or (NOR) function against a base 
of negative one. 

2. Null record is used for filler. 

3. The code word of the logging record can contain a subsysten code defined 
by the user in the first half of the uord (0:8). User logging allocs 
privileged users to past this code in the index paraneter of the OPENllG 
intrinsic. 

4. The "len" field uill contein the entire length of the data in the transac- 
tion (i.e., the length passed to URITELOG, BEGINLOG, ENDLOG). If a con- 
tinuation record is part of the transaction, it uill also contain the en- 
tire length of the data. For exanple, a length of 140 uas passed to tne 
intrinsic. The M len M field of the first record uill be 140, the "len" 
field of ite continuation record uill aleo be 140 - even though the actual 
anount of data found in the firet record uill be 119 and the data founo in 
the continuation record uill be 21. (Positive length » «; uords, negative 
length * M by tee) 



Reaaurenent Information Table 



hERSINFOTAB 



Reeerved 
for REASIO 
control 



6 

7 



11 



DST « Z73 (59) 



LDEV • OF RERSIO 
RERSIO PLRBEL 



RERSIO DST II 



HEASLDEV 
RERSPLAB 
RERSOSTN 



121 
Reserved 

for 131 

performance I 
tuning 14 j 

paraneter* 

I 
I 
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I- 
151 

I- 
161 

I- 
171 

I - 
201 

I 

I- 
211 

I 

I- 
221 

I 

I- 
231 

I 

I- 
241 

I- 
251 



GL'BflL STATISTICS XOS NURBER 

CLASS 15 STATISTICS XDS BANK 

CLASS 15 STATISTICS XDS BASE 

CLASS 15 STATISTICS XOS NURBER 

CLASS 14 STATISTICS XDS BANK 
CLP?S 14 STATISTICS XDS BASE 



~ J 



IREASSTATX- 

IDSNUR 
-I 

IREASPROC- 

IXDSBRNK 
-I 

IREASPROC- 

IXDSBRSE 
— I 

IREASPROC- 

IXOSNUR 
—I 

I 
—I 

I 
—I 
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ntaaurtntnt Information Tablt 



nEASIMFOTRB (Cont.) 



I- 



261 CLASS 14 STATISTICS XDS WW. 
27| ~CLASs"l3 STATISTICS KOS BANK 
»| "cLAsTl3 STATISTICS KOS BASE 



I- 



311 CLASS 13 STATISTICS XDS HUH. 

32 1 ""CLASS 12 STATISTICS XDS BANK 

33| "CLASS 12 STATISTICS XOS BASE 

34 1 CLASS 12 STATISTICS XOS NUfl. 



35 CLASS 11 STATISTICS XOS BANK 



36 CLASS 11 STATISTICS XOS BASE 



37 CLASS 11 STATISTICS XDS KUfl 
40 



CLASS 12 STATISTICS 2ND XOS BANK 
411 CLASS 12 STATISTICS 2N0 XOS BASE 
42| CLASS 12 STATISTICS 2ND XOS NUtl. 
43 1 "CLASS 15 STATISTICS 2ND XOS BANK 

CLASS 15 STATISTICS 2ND XOS BASE 
45 j CLASS 15 STATISTICS 2ND XOS NUN. 

** At of Rtltaat 23, all pin «t > 629 for clatttt 12 and 15 uill 
apptar in tht 2N0 set of txtra data ttgntntt. 
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Rtaaurtntnt Xnfornation Tablt 



nERSINFOTAB (Cont.) 



I 70 

I 
•hand 71 

clock 72 

inttrfact 73 

ctllt 74 

I * 

76 
77 



FLAG 



I A 



X0S2 



OCOUNT 



oumt 



TCQUNT 



tlwit 



D LABEL 



nONITOR BUFFER INDEX 



ntflS BUFFER 



I 

I 

I 

-I- 

I 100 

I 

I 101 

I 

I 1021 
I 
nttrvtd 103 
for 

•vtnt 104 HERS ENABLED FLAGS 
logging 



HEAS BUFFER INDEX 
HERS ENABLED FLAGS 



1051 

I 

1061 



HEAS BUFFER BANK 



SltONIDX 

REASBUFO 

HEASIDX 
I 

nERStiSKO 

REASnSKI 
flEASBUFBAXK 



1161 

I- 
1171 



j 

II: Interrupt hat nitttd dut to latt inttrrupt handling. 
A: Currtnt inttrrupt handling activt. 
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fltaturtntnt Information Tablt 

flERSIXFOTBB (Cont.) 

| , 

restrved . I 

f or | 

neasurtnent . I 

inttrfact I 

i • ! i 

| 501 CLASS ENABLED I CLASS 1 ENABLED 

| | COUNT I COUNT 

, | 1 

| 511 CLASS 2 EN.CNT. I CLASS 3 EN.CNT. 

, | 1 

| 521 CLASS 4 EN.CNT. I CLASS 5 EN.CNT. 

I I 1 

| 531 CLASS 6 EN.CNT. | CLASS 7 EN.CNT. 

j | 1 

| 541 CLASS 8 EN.CNT. I CLASS 9 EN.CNT. 

| | 1 

| 551 CLASS 10 EN.CNT. | CLASS 11 EN.CNT 

, | 1 

| 56I CLASS 12 EN.CNT. | CLASS 13 EN.CNT 

I 1 

I 57| CLASS 14 EN.CNT. | CLASS 15 EN.CNT 

" I 60| 

, j 

I 61 1 

rtttrvtd I — 

for 621 

thartd I — —————— 

clock 631 

intt rf act I — ——————— — — 

uttr 64| 

, , 

I 651 

, | 

I 661 

, | 

I 67| 
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Stcurity OST Layout 

Svittn Global Stcuritv DST 
DST • in SYSGLOB extension 130. 
X Tablt 1 



0| LENGTH OF FIRST TABLE 



I- 
1 1 USE COUNT 



2 | CURRENT PASSUORD ENCRYPTION (ON/OFF) 

3 1 niNinun passuoro length (« of chars) 

4 1 HAX N OF INVALID LOGON ATTESTS PER DEV. 

5| PASSUORD PROnPT REQUIREO OPTION (ON/OFF) 

6| UDC FAILURE TERMNATION OPTION (ON/OFF) 

7|"~ GENERIC LOGON INTERFACE ERROR RSG (ON/OFF) 

I- 
101 



FOPEN FAILURE LOGGING ONLY OPTION 
IDLE SESSION TWE-OUT IN SECONDS 



SECURITY OOUN TWE-OUT IN SECONDS 



12 



13 progrannatic access warning flag 



Password tMpiration inttrval in dayt 



15 Ntxt global pastuord expiration datt 



16|U|C| I I I 1 I Nunbtr of dayt to uarn 



17| Enbtddcd pastuord ditalloutd for jobt 
201 Croat tt inning disali&ued for jobt 



— \ 



21| Strc.n privilege for bypass passuord 



I- 



221 Rssura^ce of Ir-Hmg 

231 File itaxinun j,rctf*ion on creation 
I " 



>**x 



U » I'ar-ing flag set in user entry 

C " SECl' B rvrPOC - dear the warn flag 
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Sicurity OST Layout 



Sviten Glob^ ' Security OST (Cont.) 



Table 2 



o! LENCTHOFSECOMO TABLE - LOGON ATTEHPTS 



I 

I 

-/ 

1 1 LOGON flTTEHPTS COUNT - 1J0RD PER OEVICE j \ 

I I 

I I 

1 I 

I 
I 
I 

1 I 

-/ 



INDEXEO BY OEVICE NUflBER 



Table 3 



COnnflND TRBLE LENGTH (n) 



COnHRNO i 1 INFO 



-I 
I- 



2 | COnHRNO N 2 INFO 
| 



I 



n| COffllflND » n INFO 
| 



Tablt 4 



1 """LENGTH OF TABLE 4 - OEVICE PRSSUOROS 



LOGICAL OEVICE NUHBER 



PRSSUORO FOR LOGON PASS. PROI1PT (8 CHRRS) 



LOGICAL OEVICE NUflBER 



PRSSUORO FOR LOGON (8 character*) 



(ENO OF SECURITY DST) 



■\ 
I 

! 
I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
— / 

— \ 



<---/ 
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DRCO OST layout 



Steuritv Tabli - ORCO (Dev iet Rccmi Central Definition) 

I 
I 
IFLR8EL- 



HERDER. 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

■— I — I — I — t — I — I — I — I — i — I — ■ — ■ — I — I — ■ — I 

— | FILE LABEL (if ORCDDST.PUB.SYS) 
/, 



H 



LOEV 



M 



\ 
\ 

I 

I 
LDEV 2 / 



TRBLE SIZE(uordt) 



I 
—I 



DST NUHBER 



NUHBER OF ENTRIES 



UNUSED 



VTAB INDEX 



LOOP 



PSEUDO EXTENT SIZE(secton) 



UNUSED 



VTPB INDEX 



\ I 

\ 

\ 

/ 
/ 

/ 



LOEV NNNJ 



LDEV 999J 



| KODA 
LODA 
PSEUDO EXTENT SlZ^sectori) 
UNUSED 
VTAB INDEX I HODA 



-—I 



LODA 



PSEUDC EJ^UNT SIZE(s«ctor») 
UNUSED 

I 
LJDA 



VTAc INDEX 



KODA 



FSEL'ir EXTENT S12t(s»rton) 
UnMSED 



-I 



Ocvict RCD's art pointed to by the Device ACD table. T*e 
Device ACO table x« etorad inDACD0ST.PU8.SYS. Uhen the 
systen ii brought up, thu file mil be copied to a da*, 
tegnent for faster *cctst. The DACD ii indexed by ldev nunber. 
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Security DST Layout 

Connand Info Entry 

I I 1 I 2 I 3 I 4 | 5 I 6 I 7 I 8 I 9 M°_MM1M13 M_4_M5 J 

I'MTiTrTTTT'TT'i i i i i I j 



P s Progrannatically execution disabled. 
E * Execution of this connand disabled. 
L = Logging enabled for this connand. 



(^disabled, O-enabled) 
(^disabled, 0=enabled) 
(^enabled, 0=disabled) 



EQUATE 

SEC ENCRYPTION' UORD 
SEC PASS 'LEN'UORD 
SEC NUP.' ATTEHPTS' UORD 
SEC REQUIRED' PROHPT' UORD 
SECUDCTERniNATION'UORO 
SEC GENERIC HSG* UORD 
SEC FOPEN' LOGGING' UORD 
| SEC SESSION' TinEOUT* UORD 
| SEC DOUN' TIHEOUT' UORD 
| SEC PROG' URRN' UORD 
| SEC PU' AGING' UORD 
| SEC EXP 'DATE 'UORD 
| SEC UARN' DAY' UORD 
| SEC JOB' EMBED 'PU' UORD 
| SEC CROSS' STRERH' UORD 
| SEC STREAfl'PRIV' UORD 
| SEC INSURE' LOG' UORD 
| SEC flRX' PROTECT 'UORD 

EQURTE 

GLOBRL' OPTION' TRB 
RTTEHPT' COUNT* TRB 
COnnAND' INFO' TAB 
DEVICE' PRSSUORO' TRB 

EQURTE 

| TRBVLEN 

| TRB2'LEN 

| TAB3'LEN 

|«TAB4'LEN it variable» 



« 2. 
- 3, 

* 4, 
« 5. 

* 6. 

* 7, 
» 8, 
s 9. 
=10, 
•11, 
=12, 
»13, 
•14, 
«15, 
«16, 
«17, 
•18, 
•19; 



« 1. 
« 2, 
« 3, 
» 4; 



« 25, 
« 1025, 
•400; 
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Job Security Hatter Table 



TSFCPST Tahl. fDST ITS) 

DST » 61 « Z75 

SIR ■ 15 • Z17 (JIWT SIR IS USED) 



XO 

1 
2 

i 45 

I 

| Z46 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 IS 
|~|~|"|~|"l"IH"l~l"l--l~l- : l"IH--f 



j flaxinun size 

I 



current lite 



(entry 0) 



| entry size (Z46 uordt) 



| offtet to firet entry (Z46) 
| 



Reserved 



TY | JOB/SESSION NUflBER 



2nd half of J/S nunber unuted in HPE V/E 



TY | Initiator Job/Session nunber 



2nd half of J/S nunber unuted in APE V/E 



Initiator job/settion nana (4 uordt) 



ZO (entry 1) 
1 
2 
3 
4 



Initiator uter nana (4 uordt) 



Initiator account mm (4 uordt) 



Initiator* t logon ldev nunber 



Initiating date 



Initiating tine (2 uordt in CLOCK fornat) 



113 . 



Information on uho.uhen and uhere a job it ttreaned uill be ditplayed 
in the job't tSTOUST. Thit info uill be put in the Job Security 
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Job Steurity flatter Tablt 



Itattir Tablt at job crtatxen tint. 

Thi JSEC OST it tinilar to tht JRRT, thtrt it ont ptr tytttn. JSEC 
uill havt tht tant tntry size and total size at tht JRRT. Tht JRRT 
index mil bt uttd to allocate, access and dtalloeatt JSEC tntntt. 
INITIAL uill crtatt or rtcovtr tht JSEC tht tant uay it dott tht JRRT. 

Tht JSEC ii prtttrvtd on ditc in tht filt JSECOST.PUB.SYS. INITIAL 
uill crtatt DST Z75 using tht conttntt of JSECOST.PUB.SYS. 



G. 23.00 
17- 55 



Rccttt Control Definition 



j Rn RCD contittt of tht RCO HERDER folloutd by a naximm of 20 tntritt. 

Tht RCD HERDER hat 3 conpontntt: NURBER OF RCD ENTRIES, RCD CKECKSUn 
and RCD VERSION. Tht RCD VERSION includtt tht RCD RELEASE NUIKER, tht 
RCD UPDATE DATE and tht RCD UPDATE TIRE. 

NURBER OF RCD ENTRIES: Nunbtr of tntritt currtntly in thit RCD. 

RCD CHECKSUI1: R nunbtr rtprtttnting tht EXCLUSIVE OR of all tht 
uordt that conpritt tht tntritt in tht RCO. 

RCD RELEASE NURBER: A nunbtr rtprtttnting tht currtnt ACD toftuart 
uttd to crtatt the RCD. (RPE V/E VD4 > 5) 

RCD UPDATE DATE: Datt uhtn tht ACD uat last nodifitd(CALENDAR fornat). 

RCD UPDATE TIRE: Tint uhtn tht ACD uao latt nodifitd(CLOCK fornat). 

Thtrt can bt a naxinun of 20 tntritt. Each tntry contittt of an RCCOUNT 
NRRE, USER NRRE, and tht SECURITY NODES granttd to tht tptcifitd uttr. 
Uild cardt can bt uttd intttad of RCCOUNT NRftE and USER HARE. Tht only 
valid uild card uttr tptcificationt art: 

•.ACCOUNT 
0.1 

"I." it rtprtttnttd inttrnallt uith tht characttr " % ". 

Entritt art torttd at ptr tht follouing txanplt: 

Sfin.RCCTING 

TOn.RCCTING 

I.RCCTING 

ROSE. FINANCE 

I.FINRKCE 

I.I 

Each tntry contittt of: 

ACCOUNT NRRE: Tht account nana tptcifitd by tht crtator. Upshifted, 

uith trailing blanks addtd. 
USER NRRE: THE USER r*r* sptcifitd by tht crtator. Uplifted, 

uith trailing blanks addtd. 
SECURITY flODES: Thit it tht uord indicating tht accm/pemmion 
tht uttr it granttd. It is 2 byttt (1 uord). 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I — i — i — i — i — i — i — i — i — i — i — ■ — i — • — i — |— r:! 

|R I U| X| R| L| UNUSED I Z| UNUSED I N| 
| 1 

Nott: Z « Ptrnittion to rtad RCD, N * No acccst 
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Rccttt Control Dtfinitxon 



Recess Control Definition 



| An Rccttt Control Dtfinition (RCD) hat tht follouing fornat: 



Nunbtr of RCD tntntt 



RCD chtcksun 



RCO rtliast nunbtr 
RCD updatt datt 



I- 
-I 
I 
-I 



RCD updatt tint (2 uords)| 



-I- 



IRCD 

IVERSION 

I 



I 

I 

I RCD HERDER 

I 

I 
I 
I 



Recount nant (4 uordt) |- 
1 

Ustr nant (4 uordt) I 
-I 

I 
-I- 



Stcurity nodtt 



I 

| ACD ENTRY 1 

I 

I 



Recount nant (4 uordt) j I 

1 | 

Uttr nant (4 uordt) I I ACD ENTRY 2 
1 | 

ttcurity nodtt I I 



Recount nant (4 uordt) I 
1 

Uttr Nant (4 uordt) I 
— I 
I 



Stcurity nodtt 



I 

! 

| RCD ENTRY 20 

I 
I 
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Rtttagt Filtt 



CHRPTER18 RESSRGE FILES 



Rtttatt Filt Data Strveturtt 



Thit chtpttr containt tht data ttructurtt ntetttary to tupport ntttagt filtt. 
Tht first ttction dttailt tht ntttagt filt't version of tht faniliar filt 
tytttn data structure, such at tht fill label, filt control block, and tht 
acctts control bloek. 

Tht second ttction shout tht tablet uttd by tht batic IPC ntchanitn uhieh it 
a att of internal, RPE proctdurtt dttigntd to tupport tht "boundary condi- 
tions" of IPC filtt. For txanplt, signaling a no uait reader that itt record 
hat arnvtd. Stt tht ttction* t introduction for a dttailtd dttcription. 



Filt Structure 



-| END OF FILE BLOCK STRRT OF FILE BLOCK 
I . 



rut i**t/rff s«w r»« 



i- 

| DISC RDDR OF EXTENT 

I DISC RDDR OF EXTENT 1 | v 

I DISC RDDR OF EXTENT 2 I ' 

I DISC RODR OF EXTENT 3 | 

I DISC RDDR OF EXTENT n-1 \ v 

I DISC RDOR OF EXTENT n I 
| 1 

The EOF and SOF art txanpltt only, ntant to thou: 

1. Tht ttart of filt neves into tht extent nap at records art rtad. 

2. Tht filt can urap around and, htnet, cautt tht SOF to bt greater than tht 
EOF. 

Uhtn a filt btcontt tnpty tht SOF and EOF art rtttt to tht firtt block of tx- 
tent ztro. 

Each extent it composed of a nunbtr of blocks. Exttntt all havt tht tant 
nunbtr of blocks. Extent ztro alto contain! tpaet for tht filt labtl and 
user labels in the exact sane fornat as standard filtt. Starting uith bloek 
ztro, sufficitnt blocks art allocated to tht filt label /ustr labels to satis- 
fy their spact rtquirtntntt. 
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/UkV 



flcssagc Filet 

Extents outtidt of tht SOF/EOF range nay not mitt. They art deleted at 
close tine uhen there art no nort untert accessing tht file. 



Block Structure 



I 

| FIRST OflTfl RECORD 
I- 



| SECOND DRTR RECORD 
| 

| LAST DRTR RECORD 

| RECORD OELIMTER (-1) 
| 

| EflPTY SPRCE (NEXT RECORD 

| UOULD NOT FIT) 

I 



At******************************** 



EXRCT SAHE FORHAT RS STRNDRRD 
VRRIRBLE LENGTH BLOCKS. 



ft*t*tt*fttft*****ft*ft***ft*fctt******** 



, 1 

| HERDER DELMITER (Z77) I 
, J 

| LAST HERDER RECORD I 

| SECOND HERDER RECORD I 

I FIRST HERDER RECORD 

| 1 



Separating tht data portion of tht records fron thtir htadtr enables the 
standard file systen access procedures to rtad the records uith no knowledge 
that they are ntssagc file records. 



Hessage Files 



Record Fornat 



1 

NUflBER OF BYTES IN RECORD I 

-I 



FIRST DRTR UORD OF RECORD I 



-I 



LAST DRTR UORD OF RECORD I 
1 
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Length uord's value doss not include itself. 



Header Fornat 

|.-|-| 1 1 

| CI LCI EU | HERDER TYPEIO 
|._ M 1 1 

| URITER'S ID 1-1 

, 1 

C (0:1) - Set on if this uas the last record written before 
the systen crashed. This bit is set on by the 
first open on the file after the crash. 

LC (1:1) - Valid only for close headers. Set to one if this is 
the last uriter to close the file. 

EU (2:1) - Set for the last record written before the file label EOF 
uas updated. 

Type(8:8)- - data 

1 - open 

2 - close 
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Hessage Files 

Hessaes Recess Control Block 

Notes: 

1. Uords/fields that do not pertain to itttsagt files art left 
blank. 

2. This diagran shous the "contained" RCB as it appears to 
the nessage access procedures (the procedures in IPC). 
Thus it is a coitbination of the LRC8 and the PRCB. 

I 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
| ,.. M .., H ..,.. MH ..| HH ..,--|H--|H 
-5 | OST NUnBER OF THE PRCB I -5 

-4 | PRCB CONTROL BLOCK VECTOR TABLE RDDRESS |-4 

| 1 

-3 1 DST NUHBER OF THE LRCB I -3 

_ 2 j ,. 2 

, 1 

I -11 1-1 

| ,..| 1 

I 01 | SIZE OF THE RCB INCLUDING BUFFERS (UORDS) |0 
1| FILE NUnBER M * 

2| FILE NRHE |2 * 

6 1 FOPTIONS 1 6 * 

| 1 

7 | ROPTIONS I 7 * 

I 10! RECORD SIZE (BYTES) |8 * 

I 11| BLOCK SIZE (UORDS) |9 * 

I 121 " _ _ no 

I 121 CR«:RG£ CONTROL CODE (URITERS) |11 * 

.....„...——.--—— ^ ^ 

I —I 

I 151 113 

, 1 
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nessage Files 



Hessage Recess Control Block (Cont. ) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

.-|"|~I"I"|-|"|"IH"I~I-I~|-|"I~ 
ERROR CODE 

TRRNSniSSION LOG (UNITS SflnE RS LAST RD/URITE 



I 
I 

I 16 

I 17 

I 20 

I 21 

I 22 

I 23 

i 24 LOGICAL RECORD TRANSFER COUNT 

I 25 

| 26 PHYSICAL BLOCK TRANSFER COUNT 

I 27 

I 30 

I 31 



TOTAL NUHBER OF UNREAD RECORDS (INCLUDES 
OPENS AND CLOSES) 

BLOCK NUflBER OF THE FILE'S TAIL (RELATIVE TO 
THE START OF FILE BLOCK) 



DST REL ADDR OF READ HEADER 
DST REL ADDR OF UNITE HEADER 



I 321 FC8 DST 

I 331 FCB VECTOR TRBLE OFFSET 



I- 



| 34| SHARE COUNT (NUrtBER OF LACB'S) 

| 351 ACCESS CLASS, STATUS, ETC. 

I 361 LOGICAL DEVICE NUHBER 

I 37| |URT BUF INX| | « PUF - 1 

| 40| OST RELATIVE ADDRESS OF NEXT READ RECORD 

I 41| SIZE OF THE BUFFER (UORDS) | 33 



14 * 

15 * 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 

126 
127 

28 

29 

30 

31 

32 



I- 



I 42| SPARE 

| 

| 431 FHAVT INDEX 



-I 
134 



I 44| NUHBER OF READ LACB'S 



135 



136 
-I 
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Ressage Files 



Hestage Access Control Block (Cont.l 



1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 

M ~|--M--I--I~I-M~IH--M»MH 

451 TYPE AND DISPOSITION 137 

, 1 1 

461 ACCESS HASK I RECORDS PER BLOCK J38 



I- 



-I- 



-I 



47 j msc. nsc FILE FLAGS 139 

,.., 1 |~|--|~M-M-I 

5010 | • RD BUF | N UT BUF |ER|OU|n |C 10 IS |F | 

|„| 1 |~|-|"M--IH-I 

51 | NUHBER OF FREE UORD IN THE CURRENT FREE RECORD |41 

| 1 

521 NUHBER OF FREE RECORDS |42 

| 1 

531 143 



I- 



54 | NUHBER OF NONDATA RECORDS IN THE FILE 

551 
I- 



-I 

144 
-I 

145 
-I 
561 DST RELATIVE ADDRESS OF THE NEXT URITE RECORD I 46 
, 1 1 

57| NOPEN RECORDS I « RERD REQUESTS |47 

601 LAST RERO ERROR I LAST URITE ERROR |48 
| 1 1 

61| HERD RECORD'S TYPE |49 

621 HERD RECORD'S URITER ID 150 

631 HEAD RECORO'S FLAGS 151 

64 | DST REL RDORESS OF THE PRCB I 52 

65 1 DST REL ADDRESS OF THE LACB 1 53 

66 | DST RELATIVE RDORESS OF THE STACK RCB |54 

67 | STRCK DST RELATIVE ADDRESS OF DB I 55 



I- 
70 1 TARGET AREA'S DST NUHBER 



-I 
I56 



71| RESERVED FOR CALLING PARRHETERS I 57 

I 1 

721 J58 

73 L ~ _ ,59 
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Hestage Filt* 



fifing? Rccass Control Block (Cont.) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

IH-|~|.-|~|--|H--|«|-I--I~I«I--I--I--I 

74| RESERVED FOR THE STRCK HARKER FROfl FILE SYSTEH|60 

| 1 

75 I INTRINSICS 161 



I- 



-I 
|64 * 



~) 



1001 USER'S SOFT INTERRUPT PLABEL 

, 1 

1011 « OF SECONDS TO UAIT ON BOUNDARY CONDITION |65 * 



|~|--I--M~I~I--I~I- 



1021 0|EX|ND|VR|BT|in|C |U | CRRRIRGE CONTROL 
l~M~l~l-M-l"l 

1031 REPLY PORT (BRSIC IPC PORT) 



-I 
166 > 



I- 



104| URITER ID 



I- 



167 ' 

-I 

168 ' 



1051 NOURIT URITER RECORD BUFFER ADDRESS 



I- 



1061 NQURIT URITER RECORD BUFFER DST 
, 

107| NOURIT URITER BUFFER ENTRY NUHBER 



I — 



170 ' 
-I 

171 ' 
-I 

|72 ' 
-I 

173 
-I 

|74 i 
-I 

175 ' 
-I 



176 
-I 

177 
-I 



110! NO URIT I/O RESULTANT ERROR CODE 

, 

111| NO URIT I/O RESULTANT TRANSMSSION LOG 

1121 NO URIT I/O FRERD TARGET DST 

, 

1131 NO URIT I/O FRERD TRRGET ADDRESS 113* 

114| URITE UAIT QUEUE (BASIC IPC PORT) 

| 

11S| RERD UAIT QUEUE (BASIC IPC PORT) 

| 

1161 RECORD SIZE & OVERKERD 1 78 

117| HERD RECORD'S LENGTH IN BYTES |79 

1201 URITER ID 1 80 

| 1 

1211 LOCAL FLAGS 181 

, 1 

1221 TARGET DST NUHBER 182 

1231 DST RELATIVE ADDRESS OF TRRGET RRER 183 

1241 LENGTH OF TRRGET RREA 1 84 
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Hessage Files 

Hesseee Rccsm Control Bjock far\\.) 

I 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
j |.-|.. M .-|-. M .-|..|..|..|..|--I--I--I-I~I 
I 1251 URITER' S REPLY PORT. 0«USING RCB COHPLTN RRER 185 

I 1261 URITING PROCESS'S PIN 1 86 

| 127| URITING PROCESS'S FILE NUflBER 1 87 

I 1301 URITER' S SOFT INTERRUPT PLRBEL 188 

I 1311 RESULTRNT ERROR CODE 189 

I 1321 RESULTRNT TRRNSHISSION LOG 190 

I 1331 RESULTRNT URITE ID 191 

I 134| OST REL RDDRESS OF FIRST BUFFER 192 

I 1351 DST REL RDDRESS OF BUFFER TUO 1 93 



* Value it private to a particular aecmor. 
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Hessage Filet 



Ifrllttl *SCtff ftntrol B^ock (pant,) 



Sari fini Description 

XSO File's global Class. 

(1:4) - mmbtr oF read buffers 

(5:4) - nunber of urite buffers 

(9:1) ER 1 - extended read 

(10:1) QU 1 • one or nore uriters has been qutued on the 

uait queue. 
(11:1) n 1 - uait nsg is located in the RCB 

(12:1) C 1 - eonpletien nsg is located in the RCB 

(13:1) D 1 - the current urite buffer has dirty bit set 

(14:1) S - the start of file is block zero 

(15:1) F - the RCB buffers have not been filled 

X102 Accessor' s local flags. 

(0:1) 1 - have not yet issued an FRERD/FURITE against 

the file. 
(1:1) EX 1 - extended wait node. 
(2:1) NO 1 - do not destroy the next record read. 
(3:1) VR 1 - writer has not yet uritten first record. 
(4:1) BT - transnission log should be expressed in words. 
1 - " »..«... .. bytM> 

(5:1) ID 1- only user rode procedures can be soft interrupted. 
(6:1) C - no uait conpletion nessage is in LACB area. 
(7:1) U 1 - uait disablsd and just opened. 
(8:8) CAR CTL- carriage control character to be used for 

the writer's record (a value of one indicates no 

carriage control character). 



/^m, , 
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Ressage Files 








RRSTRT Definitions 








Octal 










Value 


Event Tvoe 


Paraneter 1 




Paraneter 2 


72/0 


Read init 


N free rec 






72/1 


Read conpl 


(0:8) error, 


(8:8) ID 


Nunber of record! 


72/2 


Unte init 


(0:8) ■ rec, 


(8:8) ID 


Nunber of free records 


72/3 


Write conpl (0:8) error, 


(8:8) ID 


Nunber of free records 


72/4 


Control 


(0:8) error, 


(8:8) ID 


(0:4) func, (4:12) parn 


72/5 


EOF 


(0:8) error, 


(8:8) ID 


Nunber of records 


72/6 


Open 


(0:8) error, 


(8:8) ID 


Nunber of records 


72/7 


Close 


(8:8) ttfrce, 


(8:8) ID 


Nunber of records 


72/10 


Initiation 







(0:8) fix, (8:8) update 


73/0 


Put record 


(0:8) error, 


(8:8) ID 


(0:3) rec type, 

(3:13) nunber of records 


73/1 


Delete rec 


(0:8) error, 


(8:8) ID 


(0:3) rec type 

(3:13) nunber of records 


73/2 


Oelete blk 


Start of file block • 


End of file block 41 



1. The aa/bb notation in the "octal value" colunn denotes type/subtype. Type 
is the actual RRSTRT event nunber. Subtype is (0:4) of paraneter 0. 

2. Several itens can possibly exceed their fields, in that case the bits 
beyond the field arc lost. These itens *rt nunber of records, nunber of 
frte rtcords, start of file, and end of file. 

3. Paraneter uord zero has a connon fornat for all the RRSTRT events. 

Field Descr^on, 
(0:4) Event's subtype. 

(4:2) File's state 

- enpty 

1 - partially full 

2 - only a fraction of a free record is left 

3 - conpletely full 

(6:1) Nonzero indicates that there is one or nore 
uaiting readers. 

(7:1) Nonzero indicates that there is one or nore 
uaiting uriter*. 

(11:1) Nonzero indicates that the urite has a carriage 

control character. 

(12:4) Flags local to the accessor. 

(12:1) - the accessor has done no FRERDs/FURITEs 

(13:1) - extended uait 

(14:1) - nondestructive read 

(15:1) - uriter has not uritten any records 

G. 23.00 
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Ressage Files 



Reader and Uriter Uait Queues 



Uhen an enpty nessage file is accessed by nore than one rttitr 
(share), then there nust be a uay of having the readers' FRERDs 
satisfied in the sane order that they were issued. That is, there 
nust be queue of uaiting readers. The IPC access procedures 
acconplish this by dedicating a basic IPC port as a "read uait 
queue". Uhenever a reader's request is stalled because the file 
is enpty, a nessage is sent to the read uait queue. Subsequent 
FRERDs by other processes uill queue up behind the first reader in 
a FIFO narmer. Rn FURITE uill take the first entry fron the uait 
queue and send a "read n»y be done" nessage to the reader's reply 
port. 

In a like nanrter, nultiplt uriter* uill queue on the urite uait 
queue uhen the file is full. 



Conp^etion NotjLf icatjon For NoueH j/Q 

The I0URIT intrinsic uaits for a nessage to be sent to the reply 
port(s) of the specified user files. 

Tineputf 

Uhen an accessor encounters a boundary condition (i.e., a reader 
accesses an enpty file), it nay specify that the condition nust be 
satisfied in x seconds (FCONTROL 4). To this end the IPC access 
procedures nerely issue the FCPORTSEND to the uait queue uith the 
user's tineout value specified. The tineout uill tear the nessage 
fron the uait queue and place it en the accessor' s reply port. 
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Ressage Files 



File Svstew Basic IPC D efinitions 



The objective of this set of uncallable procedures is to provide a 
Binple IPC nechanisn to support the IPC file access procedures. It 
enables one process to send short, control nessages to another process. 



Gen eral Behavior 



FCPORTOPEN Procedure 

The heart of this nechanisn is the port. R process desiring to 
receive nessages would first open (create) a port. This process is 
temed the "port nanager". Uhen the port is created, a port nunber is 
returned to the opener. Since the port nunber value cannot be knoun 
in advance, potential senders need sons nethod of obtaining the port 
nunber fron the port nanager. 

Both the ports and the nessages are contained in a single disc 
resident data segnent. There can be a total of over thirty-five 
hundred open ports and outstanding nessages, therefore, ports and 
nessage blocks are not scarce resources. 

FCPORTSEND Procedure 

This procedure sends a to 5 uord nessage to a port. Optionally a 
tineout value nay be specified uhich uill linit the duration the 
nessage uill renain attached to the port. Expiration of the tineout 
causes the nessage to be deleted fron the target port's queue and 
placed on the sender's reply port (specified by the sender in the 
FCPORTSEND procedure call). 

FCPORTRECEIVE 

Reads and deletes the head nessage fron a port. The sender's return 
port nunber is also given to the receiver, enabling hm to send a 
reply nessage. 

FCPORTCLOSE 

Denolishes the port. 



IPC File's Use Of This fiechanian 

Rll open nessage files have tuo ports open for the file (read uait 
queue and unte uait queue), plus one port per accessor (reply port). 
Their use is described in the follouing. 
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Ressage Files 



Port Data Structures 



Port Data Segnent 



I 1 

SYSTER 08 EXTENSION I PORT DST «| - 
♦ X100 | 1 



I 



| 1 | 

I l< 1 

PORT DRTR SEGRENT | GLOBAL RRER I 
I i 

I 1 

I I 

I RERRINDER IS I 
I COMPOSED OF | 
I "BLOCK SIZE" I 
I CHUNKS. I 
I I 

The chunks are a conbir.«*:on of free entries, ports, nessage queue 
entries, and tiner list entries. 



Port Uith Tuo Ou ts tanding Ressages 
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Rtttage Filtt 

Por^ Hunbfr 

| o 1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 

| ,..,-. M -M--M--l--l--l"l--l--l--MH 

I | PORT INDEX | PORT ORTR SEGAENT RELATIVE R00R/8 I 

, , 1 1 

Port indeic - Index into tht port OST mmbtr array 
Port DST Nuwber Rrrav 
Located in Sytttn OB Extension Rrta. 



1001 PORT ORTR SEGHENT NUHBER 



I- 



101 1 RESERVED FOR R SECOND PORT SEGflENT 



1 64 
-I 
I65 
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flttaage Filet 



Port Data Seowtnt Global Rrta 



1 

ORTR SEGflENT NUHBER OF THIS PORT DATR SEGflENT |0 

BLOCK SIZE IN UORDS M 
1 



TOTAL NUHBER OF BLOCKS 



nflxmun nuhber of blocks 



CURRENT NUHBER OF FREE BLOCKS 



NUHBER OF OPEN PORTS 



HERD OF FREE LIST 



TRIL OF FREE LIST 



HERD OF IHPEDED PROCESS UST 
TRIL OF IHPEDED PROCESS UST 



HERD OF TIHEOUT THREAD (TOE ADDRESS) 

TRLX OF TIHEOUT 

VRLUE RETURNED BY TWER INTRINSIC UHEN 

TIHEOUT URS INITIATED 

HERO OF PORT LIST (IN UNITS OF PORT NUHBERS) I 14 



18 
-I 

19 
-I 

110 
-I 

111 
-I 

112 
-I 

113 



•I 



NOT USED 



-I 

115 
-I 
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Hettage Filtt 
Port 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I — I — I — I — I — I — I — I — f — I — I — I — I — • — I — I — I 

0| HERD HQE RDDRESS |0 

1| TAIL HQE RDORESS |1 

2 IE I U I NEXT PORT NUHBER IN PORT UST THRER0I2 

3II | SUBTYPE I PIN OR PORT OUNER 1 3 

4 | SOFT INTERRUPT FILE NUHBER |4 

S| NUHBER OF HQES IN THE PORT'S QUEUE ' IS 
| 1 

6 | NUHBER OF SENDS TO THIS PORT I 6 

| 1 

7| SOFT INTERRUPT PLABEl |7 

| 1 

E Enablt Make up bit 

- Do not auaken the procttt 

1 - Ruaktn tht procttt 

U typt Action to be taktn en an enabled port uhtn a Rtttage it 
rtctivtd 

- Auaktn tht procttt on a nettagt uait bit 

1 - Gtntratt uttr toftuart intirrupt 

2 - Gtntratt tytttn toftuart inttrrupt 

1 Inttrrupt rtodt 

- Both priv and uttr nodt codt can bt interrupted. 

1 - Only uttr nodt can bt inttrrupttd. 

Subtypt Soft inttrrupt tubtypt 

1 - nettagt flit toftuart inttrrupta. 
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Rtttagt Filtt 
He ttaot Queue Entry (HQE) 

I 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

|-|-I-I--M--M~I--M~I-I~MHH 
01 NEXT HQE ENTRY; IF LAST, (PORT ROOR) LOR 7 |0 

| j 

1| PORT NUHBER OF RETURN PORT |1 

, 1 

2ITIHE LIST ENTRY (TL£),0*NO TWE0UT,-1«TWED 0UT|2 

| 1 

31 PRRRHETEP ZERO 13 

4| PRRRHETER ONE |4 

, 1 

51 PAR«HETER TUO 1 5 

| 1 

6| Pfi-fiHETER THREE 1 6 

I 1 

7| PRRM1ETER FOUR 17 

, | 

Tintr entry dtfinitiont - - no tintout 

1 - tjneout expired 

2 - 7LE addres* for a ponding tintout 

Filt Svtten Restate Filet 

Uait Hettagt: 

pa*** 
3 - UPITER 10 

1 - tOCPL FLAGS (dirftr uith each accettor) 

(0:1) - ecctttcr just opened filt 

(1:1) - uill uait on boundary condition if no tynbiotic procttt 

(3:1) - unter hat not written a record 

;4:1) - trantnittion log in byttt 

(8:1) - carriage control codt 

2 - DSTd of i»U buffer 

3 - Rodrett of data buf'tr (DST nlativt) 

4 - Length of data bwfftr in by*»t 

Conpletion Hettage: 

- Retultant error ced» 

1 - Reaultant trantnittion log in c>te$ 
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nessage Filet 

Tiner List Entry (Tl£) 

I o 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

0| NEXT TLE (SORTED IN INCR TIHE VRL), IF UST|0 
| 1 

1| PRECEDING TLf ENTRY (0 IF FIRST ENTRY) |1 
| 1 

2 1 NUHBER OF MLUSECONDS THE TIHEOUT VALUE 12 
I — | 

3| OF THIS Tl£ IS BEYOND THE PREVIOUS TIE |3 



4| ADDRESS OF THE AFFECTED HOE 
I 



51 ADDRESS OF THE HOE'S PORT 



-I 

14 
-I 

15 
•-! 



6| VALUE OF TWER UHEN THIS TWEOUT EXPIRES 15 

| 1 

7| (MLUSECONDS) 1 7 

, 1 



nnSTRT Otfinitiont 



Octal 

Value Event Type Paraneter 

62 Open Port nunber 

63 Receive Port nunbtr 
conpletion 



64 Send 

65 Change 
status 

66 Abort 

67 Close 
70 Expend 



Port nunber 
Port nunber 
Port nunber 
Port nunber 
Port DST nun 



Paraneter 1 

Port DST nun 

HQE address 
15:1 Uaitspc 

ME address 

15:1 Q type 

» enable 

1 * disable 

Paraneter 
zero 

Port DST 



Paraneter 2 
Flags paraneter 
Return port 

Return port 



Head HQE 
address 



Return port 



ports left 



Total ft 
blocks 



71 Tineout Port nunber 
expired 



ft expand blks 

HQE address Return port 
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HPE flenory Resident Hessage Facility 

Heosage Intrinsics 



Procedure SENOnSO(De«tpin, Subqueue, HsgLength, Flags); 
Value Destpin, Subqueue, HsgLength, Flags; 
Integer Destpin, Subqueue, HsgLength; 
Logical Flags; 

Option Privileged, Uncallable; 

Destpin, Subqueue, and HsgLength have to be uithin range or a Systen Failure 
622 uill occur. 

The caller of SENDHSG stacks the nessage contents before calling the proce- 
dure. SENDHSG expects the first nsg uord to be at C?-nsgleng»h, and the 
last nsg uord at 0-8. The nessage contents at Q-8 to Q-7-HsgLength are 
deleted fron the top of stack by the exit fron StNDnSG to the caller. 

Flags. (1:1) * 1 * Uakc-up destination process fron a nessage uait. 

Return CC ■ CCG if process uas already auaWe else CC * CCE. 

PORTSTRTUS 

Logical Procedure PORTSTRTUS (Subqueue); 
Value Subqueue; 

Integer Suooueue; 

Option Privileged, UncaJlable; 

Uhen supplied a valid subqueue nunber, PORTSTRTUS returns a true value if the 
subqueue is non-enpty and a false value if the subqueue is enpty. 

Uhen passed a -1 a subqueue peran»te<\ PORTSTRTUS returns the subqueue nunber 
of the process* nost urgent non-ennty subqueue (the snaller the nunber, the 
no re urgent the subqueue). 

If all subquaues are enpty, P&RTS7=TuS returrs CC = C'E. If at least one 
subqueue is non-enpty, PORTSTRTUS returns CC = CC*. 



HPE Henory Resident Hessage Facility 

CHAPTER 19 HPE nTHMV RESIDENT HESSAGE FACILITY 

Pv»rvi»u of Facility 

The nenory resident nessage facility of HPE V addresses the need for an effi- 
cient, sinple, and uniforn nethod for systen code to send short status-type 
nessages to processes. 

Each process is created uith a "port" in the nessage harbor table (DST X71) 
uhich supports a set of nessage subqueues uhich are private to that process. 
There are a naxinun of five subqueues per port in the initial inplenentation. 
This linit can be easily extended uhen neu subqueues *rt required. 

Any eysten code, even code running on the ICS, can send a nessage to any sub- 
queue of any process. The destination process' PIN nust be knoun, wy a 
priori conventions on subqueue nunber and nessage foraets nust be es- 
tablished. The caller of SENDHSG nay optionally specify that the destination 
process be auakened fron a nessage uait. 

A nessage can be any length up to the configured naxinun. Hessage length is 
specified in the call to SENDHSG and RECEIVEHSG. In the initial inplenenta- 
tion, nessages arc United to 6 words in length uith 4 uords available for 
data. This naxinun can easily be increased if the need arises. 

By calling PORTSTRTUS, a process nay at iny tine determine whether a 
specified subqueue is non-enpty or obtain the subqueue nunber of the nost ur- 
gent non-enpty subqueue (louest nunbered one). 

By calling RECEIVEHSG, a process nay receive the nessage at the head of the 

specified subqueue. This receive is optionally non-destructive. 

A procees can uait on a nessage uait, or on a conbination of nessage uait and 
other uait types. 
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HPE Henory Resident Hessage Facility 



RECfJVEHSG. 



Procedure RECEIVEH$G( Subqueue, HsgLength, Flags); 
Value Subqueue, HsgLength, Flags; 

Integer Subqueue, HsgLength; 
Logical Flags; 

Option Privileged, Uncallable; 

Subqueue and HsgLength hat better be uithin range or a Systen Failure 622 
uill occur. 

The caller of RECEIVEHSG does an RS$EHBLE(R0O$ HsgLength) to nake epace for 
the nessage contents. RECEIVEnSG stores the nessage contents into Q-8, 
Q-9,...,Q-7-HsgLength. Q-7-HsgLength contains the first uord of the nessage. 

Flags. (0:1) * do not release nessage fron head of subqueue (non destructive 
read). 

Return CC « CCG if all subqueues uere enpty, else CC ■ CCE. 



I 0| 11 21 31 4| 51 6| 

I LSI LI ORTR | 
M--I 1 



L$ * Subqueue or Link 
L • Length (2-6) 
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RPE Rtnory Rttidtnt Rtttagt facility 

Supporting Dm Structunt 



fleiaatt Harbor Tablt 



OST « X71 (57) 

I- 



0| DST INDEX NUnBER (271) 
I'- 



ll DATA SEGflENT SIZE I 
| 1 

21 USER REGION POINTER I 
| 1 

31 nRxinun rubber of pins ♦ 1 l 
l 1 

4 1 raxirur ItSG SIZE (6) I 

I 1 

5 1 RRX CONTEXT SIZE 

6|""rESSAGE POOL HERD POINTER 
I- 



7 | RESSRGE POOL TRIL POINTER 
I 



| 101 AVAILABLE I1SG FRRRES COUNT 



I- 



| 111 HEAD OF inPEDEO QUEUE 



I- 



| 121 TAIL OF INPEDED QUEUE 



| 131 WW • OF PENDING flSGS 



| 14| CURRENT ■ OF PENDING RSGS 



I 



l~ 



151 PORTS (16 UORDS EACH) 
| (6 FOR HERDER ♦ 2 LINK UQROS 
I FOR EACH OF 5 SU8QUEUES) 



I RESSRGES (6 UORDS EACH) 
I (2 FOR HEADER ♦ 4 FOR DATA) 
| 



HPE Rtnory Rttidtnt Rtttagt Facility 



Htatatt Harbor Table (Cont. ) 
Port 



** Nott: Tht Rtatast Harbor Tablt ttrvtt at the Sytttn Port Data Stgntnt. 
Tht Portt Facility alto allout tht crtation of additional Port Data Stgntntt 
uhich havt a tiniiar fornat. In tht htadtr of a Port Data Stgntnt othtr than 
tht Rtttagt Harbor Tablt, uordt Z13 and Z14 uill contain tht Tintr Htad and 
tht Tintr TRLX rtsptctivtly. Nttuorking toftuart it tht prinary uatr of Port 
Data Stgntntt although thty alto utt tubqututt in tht Sytttn Port Data 
Stgntnt (Rattagt Harbor Tablt). 
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RPE Htnory Rttidtnt Rtttagt Facility 



Rtaaatt Harbor Tablt (Cont.) 



Port/Subornm Explanation 
SU6QUCUE USERS: 



Exattpltt: 



Subqutut • Variout tytttn procttt function*. 
PROGEN - DFS Errors 
IORESSPROC - Rite. Rtttagt Handling 
SECURITYPROC - Rtttagtt for DOUNtd Dtviett 

Subqutut 1 - Uttr Soft Inttrruptt 

Subqutut 2 - Sytttn Soft Inttrruptt (not uttd) 

Subqutut 3 - Logon Synch bttuttn DO'STRRT & IHITJSRP. Alto uttd 
by Nttuorking Softuart. 

Subqutut 4 - L0AD/LQADER1 Coimunication . 

Each procttt hat a port » tqualing itt pin ». Port it tht Ktrntl Port 
uttd by tht Ditpatchtr & Rtnory Ranagtr routintt. Tht tubqutut aatignntntt 
for Port art at follow: 

Subqutut - Rakt Rbttnt Port 

Subqutut 1 - Stgntnt Hodification Conplttt Port 

Subqutut 2 - Rtltatt Rtgion Port 

Subqutut 3 - Fttch Stgntnt Port for I/O Dtvict Ronitort 

Subqutut 4 - Cacht Rovt Rtquttt Port 

Port 4 it utually attigntd to SYSPORTSERVER (pin 4) uhich hat itt oun 
uttt for tht tubqututt at follows: 

Subqutut - Not uttd 

Subqutut 1 - Port Stgntnt Conplttor 

Subqutut 2 - Port Tintout 

Subqutut 3 - Not uttd 

Subqutut 4 - Port Enablt 
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01 FLAGS 



21 



3 CONTEXT 



RflSK 



PIN 



TYPE 



5 P LABEL 



SUBQ HEAD 



6 

7 

101 SUBQ 1 HEAD 
I- 



SUBQ TAIL 



111 SUBQ 1 TAIL 
| 

121 SUBQ 2 HEAD 
I 

131 SUBQ 2 TAIL 
| 

14| SUBQ 3 HEAD 

I- 



151 SUBQ 3 TAIL 
| 

161 SUBQ 4 HEAD 



I- 



17| SUBQ 4 TAIL 



10 
11 
12 
13 
14 
15 
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RPE Htnory Rttidtnt Rtttagt Facility 

Bttaaaa Harbor Tablt (Cont.) 



Htttatt 



0| LINK 
| 

1| LENGTH 
| 

21 

3 | DATR 

4| 

51 
I 

6| 

7| 
101 
111 



Tintr 



| 

0| LINK 
I 

1| LENGTH 

21 REQ ID 
| 

31 SUB QUEUE 



I- 
4 1 DELTR TIRE 

I 
51 

I 

6| REPLY PORT 

I 
71 

| 



**)) 
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CHAPTER 20 


RRSTATS EVENTS 






HRSTATS Catalog Index 






Event No. 




Event No. 


Event Mane 


OEC. Z 


Event Nane 


OEC. 1 


flLCSTBLK 


20 024 (-) * 


FRERO 


62 076 (-) 


ALLOCRER 


12 014 * 


FRERODIR 


64 100 (-) 


AUAKEDEV 


82 122 * 






BINREAD 


233 351 (-) * 


FRERO LABEL 


76 114 (-) 


BREAK 


237 355 (-) * 


FRERDSEEK 


68 104 (-) 


C ABSENT 


139 213 * 






CflBORTIO 


142 216 * 


FRENRRE 


80 120 (-) 


CflCHEnOV 


14 016 * 






C CLOSE 


146 222 ' 


FSETHODE 


72 110 (-) 


CCLOSETRACEFILE 


154 232 « 


FSPRCE 


69 105 (-) 


CCONTROL 


152 230 * 


> FUNLOCK 


79 117 (-) 


CDT ATT 


86 126 ' 






CGARBAGE 


7 007 * 


FUPDRTE 


66 102 (-) 


CONFIG-INFO 


221 335 (-) * 


FURITE 


63 077 (-) 


CONFIG-IHFO 


222 336 (-) « 


FURITEOIR 


65 101 (-) 


CONFIG- INFO 


223 337 (-) ' 


FURITELRBEL 


77 115 (-) 


COPEN 


140 214 * 


k GIPINTERRUPT 


192 300 






' GET COT 


15 017 


COPENTRflCEFILE 


153 231 * 


» XOBUFTRRP 


125 175 


CPOLLIST 


155 233 < 


' I/O COHPLETION 


111 157 (-) 






1 INITIATE 


84 124 


CREflO 


147 223 * 


' IOURIT 


67 103 (-) 






' LINK REG 


89 131 


CRERD 


160 240 * 


» nAKEOC 


1 001 






» RAPJOH 


87 127 


CSDRIVER 


150 226 ' 






CSIOMRIT 


144 220 < 


► nONOFF 


229 345 (-) 






* PFAIL 


240 360 (-) 


CURITE 


149 225 ' 


' PROCESS COnPLETE 


211 323 (-) 


DC1DC2ACK 


231 347 (-) < 


> QONOBJ 


000 






» QUE LOR 


16 020 


OERLLOCn 


13 015 


1 QUlfSCE 


40 050 


DEALCSTBLK 


21 025 (-) 


» AELRESOURCES 


23 027 (-) 






» REQCRCHE 


90 132 


DISKBUGCATCHER 


200 310 


' SEGIO 


5 005 






» SIOOH-ENTRY 


194 302 


OXSKBUGCRTCKER 


201 311 


1 SIOOn-EXIT 


195 303 


OISKERROR 


100 144 (-) 


» SIOOONE 


6 006 






» SIOP-UST 


193 301 






* SOFT' DEATH 


120 170 
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nnSTATS Catalog Index (Cont.) 






OISKERROR 


101 


145 (-) 


* 


SPECCHAR 


236 


354 (-) 


OISKINTRPT 


191 


277 


• 


SPECIALRQ 


2 


002 








* 


SPECREAD 


238 


356 (-) 








t 


START I/O 


110 


156 (-) 








* 


STACK OVERFLOU 


25 


31 








* 


STRATEGY 


83 


123 


DISK TRAFFIC 


98 


142 (-) 


t 


SUAPIN 


8 


010 


OOUE LOR 


17 


021 


* 








FCHECK 


74 


112 (-) 


* 


SYSPINS 


224 


340 (-) 


F CLOSE 


81 


121 (-) 


* 


SYSPINS 


225 


341 (-) 


FCONTROL 


71 


107 (-) 


* 


SYSPINS 


226 


342 (-) 


FETCHSEG 


4 


004 


* 


SYSPINS 


227 


343 (-) 


FGETINFO 


75 


113 (-) 


* 


TERfl LOGOFF 


235 


353 (-) 


FINO OE 


18 


022 


* 








FLOCK 


78 


116 (-) 


* 


TERH LOGON 


234 


352 (-) 


FOPEN/(Ofl) 


60 


074 (-) 


* 


TERRREAD 


230 


346 (-) 


FOPEN' 


61 


075 (-) 


* 


TERRURITE 


232 


350 (-) 








A 


TIRESTARP 


228 


344 (-) 


FPOINT 


70 


106 (-) 


* 


UN HAP RG 


88 


130 



(-) = Events are not logged in flonitor Table but n»y be logged on 
nagnetic tape. 
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RRSTATS Events 



finSTRT CATALOG INDEX 



RRSTAT Event Group (Renorv Ranaoer) 



Event 
Group 


Description 
pf Group 


Page 





nEnORY RANAGER 


20-4 


1 


RERORY RANAGER/CACHING 


20-11 


2 


RERORY RRNAGER 


20-15 


4 


SCHEDULING 


20-17 


5 


IPC/nSG FILE 


20-18 


6 


FILESYS 


20-24 


7 


FILESYS 


20-31 


8 


FILESYS/CACHING 


20-35 


9 


DISC I/O TRRNSrER/CRCHlNG 


20-41 


10 


DISC ERRORS 


20-42 


11 


SIO 


20-43 


12 


DISC Sf-ACE 


20-44 


13 


DISC CACHING 


20-47 


14 


CS/3000 


20-48 


15 


CS/3000 


20-51 


16 


CS/3000 


20-54 


19 


DISC CONTRCiLER INTP^T 


20-55 


20 


PRIVATE voiunrs 


20-58 


21 


PROCESS CREATION AND TERMNATION 


20-59 


22 


-ONlTOR CONFIG INFORMATION 


20-60 


23 


TERRML I/O 


20-65 


24 


POKR fo:l 


20-70 



QONOBJ 

ABSENCE TRAP ON COOE/OATA SEGflENT 

KERNELC 
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Event 

EVENT NRRE: 

DESCRIPTION: 

CALLING ROOULE: 

CALLING PROCEDURE(S): QUEUEONOBJECT 

Paraneter pescript^n 

P1.P2 ■ Stgnent Identifier 

PI. (0:4) « Segntnt type Field 

« Data Segnent 

1 « SL Segntnt 

2 ■ Progran Segnent 

3 • Cache Donain 

PI. (4:12) ■ Progran Index Into CSTBLK (Type 2 Only) 

P2 « Segntnt Nunstr 
P3 « SLL Pointtr (SLL Tablt Relative) 

P4 ■ STATUS Uord (Fron Stack Rarktr) Of Calling (Trapping) Stgnent 
P5 • P REG Uord (fron Stack Rarktr) Of Calling (Trapping) Segnent 
P6 ■ Not Used 
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EVENT NRUE: 
DESCRIPTION: 

CALLING nODULE: 



flAKEQC 

HRKE SEGflENT RN OVERLAY CANDIDATE - RELERSE 
SEGflENT TO THE POOL OF AVAILABLE SPACE 



KERNE LC 
CALLING PROCEDURE(S): I1AKEOC 

Parantttr Description 

P1.P2 * Stgntnt Idtntifitr 

P1.(0:4) • Stgntnt Typt Fitld 

* Data Stsntnt 

1 « SL St$ntnt 

2 * Progran Stgntnt 

3 * Cacht Donain 

P1.(4:12) * Progran Indtx Into CST8LK (Typt 2 Only) 

P2 » Stgntnt Nunbtr 
P3 « Bank Of Rtgion 
P4 « Address Of Rtgion 
P5-P6 - Not Uttd 

Evtnt 2 

EVENT NAflE: 
DESCRIPTION: 

CALLING HODULE: 



SPECIRLRQ 

REQUEST OF SEGflENT EXPANSION/CONTRACTION, UNLOCK, 
UNFREEZE, IOUNFREEZE, LOCK, IOFREEZE, FREEZE 

KERNELC, KERNELD, ININ 



CALLING PROCEDURE(S): UNLOCKSEG', IOFREEZE', FETCHOBJECT-(KERNELC) 
DLSIZE. ZSIZE, GETPXSEG, ALTDSEGSIZE, 
RLTPXFILESIZE-(KERNELD), STRCKOVERFLOU-(ININ) 
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Evtnt 4 

EVENT NOTE: 
DESCRIPTION: 
CULLING RODULE: 



FETCHSEG 

SEGHENT REQUEST (FOR I/O SYSTED OR PROCESS) 

KERNELC 



CALLING PROCEDURE(S): FETCHSEGflENT 
Parantttr Due notion 

P1.P2 * Stgntnt Idtntifitr 

PI. (0:4) * Stgntnt Typt Fitld 

* Data Stgntnt 

1 « SL Stgntnt 

2 » Progran Stgntnt 

3 * Cacht Donain 

P1.(4:12) * Progran Indtx Into CSTBLK (Typt 2 Only) 

P2 * Stgntnt Nunbtr 

P3 * Rtquttttr 10 

.(0:1) « 1 "I/O Sy?ttn Rtquttt 

.(1:15) = Ldtv N 
.(0:1) * « Process Rtquttt 

.(1:15) » PIN • Of Requesting Process 

.(1:1) « 1 « I0FREE3E Rtquttt 

.(2:1) » 1 a Blocked LOCK Request 

.(3:1) « 1 • LOCK Rtquttt 

.(4:1) « 1 • FREEZE Rtquttt 

P4» .(13:3)* « Stgntnt Already Present 

=• 1 * Stgntnt Is Rtcov*r Overlay Candidate 

* 2 s 3eo»«ert Rl r*ady On Its Uay I" Far Sontont 

(Segntrt In notion In) 
a j * Segntrt Met Prtstnt, fast Ftteh 

(rull Fttch) 

P5-P6 - Not Uftd 
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Parantttr Deteriotion 



P1.P2 » Stgntnt Idtntifitr 

P1.(0:4) « Stgntnt Typt Fitld 

* Data Stgntnt 

1 * SL Stgntnt 

2 * Progran Segnent 

3 » Cacht Donain 






P1.(4:12) > Progran Indtx Into CSTBLK (Progran Stgntnt Only) 



P2 



* Stgntnt Nunbtr 



P3 » .(0:1) » 1 • If FETCHIOBJECT It Calltd Uith I/O FREEZE. FREEZE 
Or LOCK Options 
.(12:4) Typt Of Requtst 

* « IOFREEZE 
» 1 * FREEZE 

« 2 * LOCK 

* 3 = IOUNFREEZE 
« 4 > UNFREEZE 

* 5 = UNLOCK 

a 6 » DLSIZE Expansion 
a 7 « DLSIZE Contraction 
a 10 a PXFIXED Expansion 
a 11 a PXFILE Expansion 
a 12 a PXFILE Contraction 
a 13 » XDS Expansion 
a 14 a XDS Contraction 
a 15 a ZSIZE Expansion 
a 16 a ZSIZE Contraction 
- 17 a STRCKOVERFLOU 

P4 > For Typtt (P3.(12:4)) 

a 0,2,3,5 a P4.(8:8) * LOCK Or IOFREEZE Count 
a 1,4 a P4. (0:8) « FREEZE Count 
a 6-16 a Requttttd Sizt Of Rrta In (lords 

■ 17 « S Rtg Valut Uhtn Stack Overflow Occurred 

P5 • Status Uord If Rtquttt Typt It STRCKOVERFLOU 

P6 > PDISABLE Count If Rtquttt Typt It STRCKOVERFLOU 
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Evtnt 5 

EVENT NAflE: 
DESCRIPTION: 

CALLING RODULE: 
CALLING PROCEDURES): 



SEGIO 

nCRORY RANRGCnCNT READ/URITE OF SEGflENT FROfl/TO 
DISC QUEUED 

KERNELC 

PROCESSINITBSG, STRRTSEGURITE 



P1.P2 « Stgntnt Idtntifitr 

PI. (0:4) « Stgntnt Typt Fitld 

a Oata Stgntnt 

1 « SL Stgntnt 

2 ■ Progran Stgntnt 

3 * Cacht Donain 

P1.(4:12) • Progran Indtx Into CSTBLK (Typt 2 Only) 

P2 ■ Stgntnt Nunbtr 

P3 • Disc Rtquttt Indtx - (DRQ Tablt Rtlativt) 

P4 ■ .(0:1) • 1 » WRITE START 
a a RERD START 
.(1:15)- Ldtv M 

PS-P6 - Not Uttd 



M%.. 
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lyentj 

EVENT NRHE: 
DESCRIPTION: 

CALLING MODULE: 



SIODONE 



HEHORy flfiNRGEriENT SEGflENT RERD/URITE FROn/TO DISC 
COflPUETE 



KERNE LC 



CALLING PROCEOURE(S): SEGREADCOHPLETOR, SEGURITECOI1PLETOR 
Paraneter Description 

P1.P2 * Segnent Identifier 

P1.(0:4) * Segnent Type Field 

* Data Segnent 

1 = SL Segnent 

2 * Prog ran Segnent 

3 B Cache Donain 

P1.(4:12) » Progran Index Into CSTBLK (Type 2 Only) 

P2 * Segnent Nunber 

P3 * Disc Request Index - (DRQ Table Relative) 

P4 « .(0:1) « 1 * Urite Conplete 

« * Read Conplete 

P5-P6 - Not Used 
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Event 7 

EVENT NRHE: 

EVENT DESCRIPTION: 

CULLING nODULE: 



C GARBAGE 

GRRBRGE COLLECTION KRS JUST TAKEN PLACE 

KERNE LC 



CALLING PROCEDURE(S): COLLECTGflRBROE 

Paraneter Description 

P1 s Bank of Source Just floved Fron 

P2 * RDDR of Source Just floved Fron 

P3 * nOVEPRGECNT, Nunber of Pages Just floved Fron 

P4-P6 - Not Used 

Evfnt 8 (110) 



EVENT NRHE: 
DESCRIPTION: 
CALLING (10DULE: 



SURPIN 

SURP IN R PROCESS 

KERNE LC 



CRLUNG PROCEDURE (S): SURPIN 



Paraneter Description 



P1 - PIN of Process Being SURPPED In 

P2 • .(0:1) » ■ Being SURPPED 

* 1 « End SURP 

.(1:1) * * Nornal (Partial SURP OK) 

* 1 * SURP Required 
.(12:4)* * Process SURPIN Conplete 

2 » No Roon, Hard REQ flay Succeed 

3 * No Roon, Hard REO Failed 

4 = SURPIN Stopped - Hore Urgent Activity 
8 * No Lock Space 

P3 « HRRDREQUEST * TRUE « Hard Request On SURPIN 
FALSE* Nornal 



P4-P6 - Not Used 
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nnSTRT Event Group 1 (flenorv fltnaoer/Cachinq) 



Event 1? (114) 

EVENT NRflE: 
DESCRIPTION: 
CALLING nODULE: 



ALLOtriEII 

FOUND A HOLE FOR R SEGflENT REPLACEHENT REQUEST 

KERNELC 



nnSTRTS Events 

Event 14 (Z16) 

EVENT NRHE: 
DESCRIPTION: 

CALLING nODULE: 



CRCHEflOV 

A CACHE HOVE (I.E., LOGICAL DISC REQUEST) HAS 
JUST COHPLETED 

CACHESEG 



CALLING PROCEDURE(S): RESERVEREGION 

Paraneter Description 

P1 * Requested Size In Paget 
P2 = Bank Of Selected Region 
P3 « Rddress Of Selected Region 
P4-P6 - Not Used 



Ev«"t 13 (115) 

EVENT NRHE: 
DESCRIPTION: 
CALLING nOOULf: 



DEALLOCTI 

RELEASE REGION OF REIfORY TO AVAILABLE STATUS 

KERNELC 



CRLLING PROCEDURE(S): RELERSEREGION 
Paraneter Description 

P1 * Size Released In Paget 

P2 3 Bank Of Released Region Base 
P3 * Rddress Of Released Region Bast 
P4-P6 - Not Used 



G. 23.00 
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CflLQKG PROCEDURE(S): PROCESSCDTLOGREQOUE 

Paraneter Description 

P1.P2 = Segnent Identifier Of Target DST (LDR'BUFOST) 
P2.(0:1) s 1 Then This Is fl Stack 

P3 * "apped Donain CDT Entry Nunber 

P4 * Transfer Count 

P5-P6 = Unused 



GET COT 



CALLED UHEN RN ENTRV IN THE CDT T05LE IS 
OBTAINED CR RELEASED. 



E vent 15 (Z17) 

EVENT NRHE: 
DESCRIPTION: 

CALLING MODULE: CRCHESEG 

CALLING PROCEDURE(S): GET 'COVENTRY, CDT'fREE'ENTRY. 

CDT' GET' HD' ENTRY, CDT 'RELTID' ENTRY 

Paraneter Description 



P1 » CDT Entry Nunber 

P2 * Type of call 

* Free entry 

1 = Get F-try 

2 - Get Happed Donair. Entry 

3 = Release napped Domain E^try 



P3 


* If P2=3 Then Ldev Entry Hvrbtr 


P4-P6 


- Not Used 
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Hnt If (X20) 

EVENT HARE: QUE.LDR 

DESCRIPTION: CRLLEO UKEN RN LDR IS QUEUED ONTO THE COT 

CALLING HODULE: CRCHESEG 

CRLQNG PROCEDURE(S): CDT'QUEUE'LDR 

Paraneter Description 

PI * Rapped Donain CDT Entry Nunber 

P2 » LDR Entry Index To Be Queued 

P3 * Queue Type 

Z12 - CDT Inpeded Queue 
213 - CDT Rctive Queue 

PA-PS - Not Used 



Event 17 (Z21) 

EVENT NftHE: 
DESCRIPTION: 
CRLQNG nODULE: 



DQUE.LDR 

CRLLEO UKEN RN LDR IS REROVED FROn THE CDT QUEUE 

CRCHESEG 



CRLQNG PRQCEDURE(S): CDT' DEQUEUE' LDR 

Paraneter Description 

PI * Rapped Donain CDT Entry Nunber 

P2 * LDR Entry Index Being Renoved Fron The Queue 

P3 * Queue Type 

212 - CDT Inpeded Queue 
X13 - CDT Rctive Queue 

M-P6 - Not Ueed 
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nnSTRTS Events 

EVENT NRRE: 
DESCRIPTION: 



FINDJJE 

CALLED UHEN NEED TO FIND RN ASSIGNED CDT 
DEVICE ENTRY 



CALLING HODULE: CACHESEG 
CRLUNG PROCEDURE(S): CDT'FIND'DE 

Paraneter Description 

PI s LOEV Nunber Of The CDT Device Entry To Be Found. 
P2 ■ CDT Device Entry 
P3-P6 - Not Uted 



Event 19 (Z23) 

EVENT NRRE: 
DESCRIPTION: 
CRLQNG HODULE: 
CRLQNG PROCEDURE(S): 



LOCKRRNG 
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MSTRT Event Sraun 2 (nenorv Hana«or) 



RLCSTBLK 

REQUEST TO RESERVE R BLOCK OF ENTRIES IN THE CSTX 

KERNELD 



Event -20 (-124) 

EVENT NRHE: 

DESCRIPTION: 

CRLQNG HODULE: 

CRLQNG PROCEDURE(S): RLCSTBLQCX 

Parameter Description 



P1 « EIX * CST Block Index Resigned 

P2 » CSTX * DST Relative Index OF Uord OF The Firet Reserved CSTX Entry 
P3 a N * Nunber Of CSTX Entries Reserved 

P4-P6 - Not Used 



RflSTATS Events 

Event -?3 (-X27) 

EVENT NRRE: 
DESCRIPTION: 

CRLQNG ROOULE: 



RELRESOURCES 

RESOURCES (VDS.HRIN ItEHORV. ST ENTRY) RESERVED 
FOR THE SEWtENT HAVE BEEN RELERSED 

KERNELD 



CRLQNG PROCEDURE(S): RELDRTASEG 
Paranmr pfscrjotten 

P1 ■ Neu DB DST Nunber 
P2 - DELTR P Rt EXCHRNGEDB Call 
P3 ■ Status Rt EXCHRNGEDB Call 
P4-P6 - Not Used 



Event -21 (-Z25) 

EVENT NRHE: 
DESCRIPTION: 



INDICATES THAT A CST EXTENSION BLOCK MRS BEEN 
DEALLOCATED 



CALQNG HODULE: KERNELD 

CRLQNG PROCEDURE(S): DERLCSTBLQCX 

Paraneter Description 

Pi * £IX * tST Block Index Resigned To The Block OF CST Entries 

P2 « CSTX * DST Relative Index Of Uord Of The First CST Entry 
To Be Released 

P3 « fltnT * (NRliocated CSTX Entries- REntriee Being Released)^ 

P4-P6 - Not Used 
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Event 2S(X31) 

EVENT NRRE: 
DESCRIPTION: 

CRLQNG ROOULE: 
CRLQNG PROCEDURE: 



STRCKOVERFLOU 

INDICATES THAT S>2 (NORRAL STACK EXPRNSION 
NEEDED) OR THRT SXMXDRTfl (STACK OVERFLOU RBORT) 

ININ 

STRCKOVERFLOU 



Paraneter Description 

P1 > Current process* PCB RESfiBQRTIWFO UORD 

P2 • Current process* PCB PROCSTATE UORD 

P3 ■ Current process' S Register value 

P4 » P Reg uithin nodule receiving overflow 

PS ■ STRTUS UORD of nodule receiving cverflou 

P6 • PDISRBLE count 
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RRSTATS Events 



HnSTflT gvgnt Group 3 
(NOT CURRENTLY ASSIGNED) 

HRSTAT Event Group 4 (Scheduling) 



Evnt 40 (150) 

EVENT NRRE: 

DESCRIPTION: 

CALLING NODULE: 

CALLING PROCEDURE(S): DSP 

Paraneter Description 



QUIESCE 

PROCESS SUITCH - STRTE OF PROCESS SRVED 

KERNE LC 



P1 * PCBOO(CPCB) 






.(0:1) * 1 


* SRR 


- Scheduling Attention Required 


.(2:1) * 1 


« CRIT 


- Process Is Critical 


.(3:1) * 1 


* HSIR 


- Process Has SIR 


.(4:1) * 1 


« PIOVR 


- Pending PI, Process Critical 

- Hold SIR Priority 


.(5:1) * 1 


« HSPRI 


.(6:1) « 1 


« IPEXP 


- In core Protect Expired 


.(7:1) « 1 


« PC 


- Precnpt Capability 


.(8:1) * 1 


« np 


- Ilust Preenpt 


.(9:1) « 1 


« LU 


- Long Uait 


.(10:1)* 1 


« SU 


• Short Uait 


.(11:1)8 1 


* TRU 


- Terninal Read Uait 


.(12:1)= 1 


. USEQD 


- Used R Quantun Since Transaction Began 


.(13:1)* 1 


* HIPRI 


- Hold Inpeded Priority 


.(14:1)* 1 


* Allou Soft Intirruptt Even Though In 




Syster 


i Code 


.(15:1)* 1 


• RITBK 


- Process In RIT Break 


P2 « PCB04(CPCB) 






.(0:1) « 1 


« n 


- Rourning Uait 

- Global RIN Uait 


.(1:1) - 1 


> RG 


.(2:1) « 1 


« RL 


- Local RIN Uait 


.(3:1) * 1 


* ra 


- Hail Uait 


.(4:1) « 1 


* BIO 


- Blocked 10 Uait 


.(5:1) « 1 


■ 10 


- 10 Uait 


.(6:1) « 1 


« UCP 


- UCOP Uait, RIT Uait 


.(7:1) « 1 


« JNK 


- Junk Uait 


.(8:1) « 1 


« Tin 


• Tiner Uait 


.(9:1) « 1 


■ INT 


- Interrupt Uait 

G. 23.00 
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RRSTRTS Events 



Paraneter Description 

PI » Port Nunbtr 

P2 « Itessage Addrtts/Flags 

P3 « Return Port 

P4-P6 - Not Used 

Event -52 (-X64) 

EVENT NARE: FCPORTSEND 

DESCRIPTION: SEND TO BIPC PORT 

CALLING ItODULE: BIPC 

CALLING PROCEDURE: FCPORTSEND 

Paraneter Description 

P1 • Port Nunbtr 

P2 * nessage Rddrtss/Fligt 

P3 « Return Port 

P4-P6 - Not Used 

Even^ -S3 (-Z§5) 

EVENT NRttE: PORT STATUS CKRNGC 

DESCRIPTION: ENRBLE/DISRBLE BIPC PORT 

CALLING ROOULE: BIPC 

CALLING PROCEDURE: FCPORTENABLE/FCPORTOISRBLE 

Paraneter Description 

PI « Port Nunbtr 

P2 « * Enable; 1 > Disable 

P3 * Rddress of First nessage 

P4-P6 - Not Used 
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.(10:1)* 1 « SON 

.(11:1)* 1 * FA 

.(12:1)* 1 « IHP 

.(13:1 )• 1 » SIR 

.(14:1)* 1 « Tin 

.05:1)* 1 « nsn 



- Son Uait 

- Father Uait 

- Process Uaiting To Uninpeded 

- Process Waiting For SIR 

- Process Uaiting For Tine Out 

- Process Uaiting For Henory 



P3 * PCB13(CPCB) 
(0:1) 

.(1:1) ■ 
.(2:1) » 
.(3:1) = 
.(4:1) « 
.(5:1) « 
.(6:1) = 
.(8:8) '• 

P4-P6 - Not Used 



* 1 * DISPQ - Process On Dispatching Queue 

1 * L Scheduling Class 

1 * C Scheduling Class 

1 * D Scheduling Class 

1 * E Scheduling Class 

1 * Inter-Process Is Interactive 

1 * Corer-Process Is Core-Resident 
Process* Scheduling Priority 



nnSTRT Event Group 5 (IPC/nSG File) 



Event -50 C-Z62) 
EVENf NflHE: 
DESCRIPTION: 
CALLING nOOULE: 
CALLING PROCEDURE: 

Paraneter Description 
P1 * Port Nunber 
P2 * Port DST Nunber 
P3 - Flags 
P4-P6 - Not Used 

Evtn^ -51 (-163) 
EVENT NRRE: 
DESCRIPTION: 
CALLING NODULE: 
CALLING PROCEDURE: 



FCPORTOPEN 
OPEN BIPC PORT 
BIPC 
FCPORTOPEN 



FCPORTRECEIVE 

RECEIVE RESSAGE FROn 8IPC I 

BIPC 

FCPORTRECEIVE 

G. 23.00 
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Event -54 (-166) 

EVENT NARE: FCHSGABORT 

DESCRIPTION: PURGE RESSAGES 

CALLING ROOULE: BIPC 

CALLING PROCEDURE: FCHSGABORT 

Paraneter Description 

P1 « Port Nunber 

P2 * Hatch Paraneter 

P3 * Return Port 

P4-P6 - Not Used 

Event -55 (-Z67) 

EVENT NRRE: FCPORTCLOSE 

DESCRIPTION: CLOSE BIPC PORT 

CALLING RODULE: BIPC 

CALLING PROCEDURE: FCPORTCLOSE 

P aranetei Description 

P1 * Port Nunber 

P2 * Port DST Nunber 

P3 « Nunber of Ports Left Open 

P4-P6 - Not Used 

Event -56 (-Z7Q) 

t.TNT HflnE: EXPRNDPORT SEG 

DESCRIPTION: EXPAND BIPC PORT TRBLE 

CALLING nOCULE: BIPC 

CALUs:- PROCEDURE: EXPRNDPORTSEG 
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nitSTRTS Events 



Paraneter Description 
P1 « Port OST NuRbtr 
P2 • Nunber of Blocks Pddtd 
P3 * Total Nunber of Blocks 
P4-P6 - Not Ustd 

Ev«nt -57 M71) 

EVENT NAfiE: TMEOUT EXPIRED 

DESCRIPTION: AESSAGE TMER EXPIRED 

CALLING HODULE: FCPOSTMEOUT 

CALLING PROCEDURE: FCPOSTWEOUT 

Paraneter Dascriotion 
PI « Port Nunber 
P2 « Aeeeage Rddrtss 

P3 « Rttum Port 
P4-P6 - Not Ustd 

Event -58 (-Z72) 

EVENT NAHE: IPC INTERNAL EVENT 

DESCRIPTION: IPC INTERNAL EVENT 

CALLING HODULE: IPC 

CALLING PROCEDURE: flRKEAnSTAT 



nnSTATS Events 



Parantter Description 

The paraneter values are a function of the event and the first four 
(4) bits of paraneter 1, which is a subtype. 

P1 Bits ( 0:4) - Subtype 

( 4:2) - File State 

* Enpty 

1 * Non-enpty 

2 s Less Than One Full Record Left 

3 = Full 

( 6:1) * 1 * Uaiting Readers 
( 7:1) « 1 » Waiting Unters 
(11:1) * Carriage Control Characters 
(12:4) * Local Flags 



Event/ 










Subtype 


Nane 


P? (0??) 


P2 (8:8) 


a 


72/0 


Read Initiation 


Record Nunber 


ID 


Nunber of Records 


72/1 


Read Conpletion 


Error 


10 


Nunber of Records 


72/2 


Unte Initiation 


Record Nunber 


ID 


Free Records 


72/3 


Urite Conpletion 


Error 


ID 


Free Records 


72/4 


Control 


Error 


ID 


(0:4) « Function 
(4:12) * Paraneter 


72/5 


EOF 


Error 


ID 


Nunber of Records 


72/6 


Open 


Error 


ID 


Nunber of Records 


72/7 


Close 


Free Records 


ID 


Nunber of Records 


72/10 


Initialization 








( 0:8) « FN 
( 8:8) « Update 



P4-P6 - Not Used 
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EVENT NAK: IPC INTERNAL EVENT 

DESCRIPTION IPC INTERNAL EVENT 

CALLING ROOULE: IPC 

CALLING PROCEDURE: HAKETOWTAT 



Paraneter Description 

The paraneter values are a function of the event and 
(4) bits of parantter 1, uhich is a subtype. 

P1 Bits ( 0:4) > Subtype 

( 4:2) * File State 

* Enpty 

1 * Non-enpty 

2 ■ Less Than One Full Record Left 

3 - Full 

( 6:1) ■ 1 > Uaiting Readers 
( 7:1) « 1 * Waiting Writers 
(11:1) « Carriage Control Character* 
(12:4) > Local Flags 



imSTATS Evente 

nnSTAT Event Group 6 (FILESYS) 
These events ere for developnent use only and are not nomally enabled. 
Event -60 (-X74) 



the first four 



EVENT NRI1E: 
DESCRIPTION: 
CALLING RODULE: 



FOPEN 

OLD FILE OPEN 

FILEACC 



Event/ 

Subtype Nant 



P2 (0:8) 



P? («:» £1 



73/0 
73/1 



Put Record 
Delete Record 



ID 



73/2 Delett Block 



P4-P6 - Not Ueed 



Start of File 
Block Nunbtr 



( 0:3) > Rectype 
(3:12) «» of Records 
(0:3) « Rectype 
(3:12) = * of Records 
End of File Block 



CALLING PROCEDURE(S): FOPENOA 

Paraneter Description 

PI » FILE A « (0:2)*2 -> Non-Spooler Access 
(0:2).NE.2 -> 

P2 « AOPTIONS • See Intrinsics Aanual 

P3 » File Label F OPTIONS • See Intrinsics 

P4 s Record Size 

P5 • File label Block Size 

P6 ■ • Of Buffers 
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"\ 
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HJISTRTS Evtntt 



r 



/#*N 



j^^X^ 



Evtnt -61 (-175) 

EVENT NRnE: FOPEN' 

DESCRIPTION: OLD FILE OPEN (CONTINUATION OF EVENT -60) 

CRLUNG flODULE: FILERCC 

CRLUNG PROCEDURE(S): FOPENDR 

Paraneter Description 

P1 * File Label File Unit - HSU 

P2 * File Label File Unit - LSU 

P3 * File Label » Of Extents 
P4-P6 - Unused 

Event -60 (-174) 



EVENT NRHE: 
DESCRIPTION: 
CALLING nODULE: 



FOPEN 

NEU DISC FILE OPEN 

FILERCC 



CALLING PROCEOURE(S): FOPEN 

Paraneter Description 

P1 * FILE t * (0:2)«2 * Non-Spooler Recces 
(0:2).NE.2 - 

P2 ■ ROPTIONS - See Intrinsics Hanual 

P3 « FOPTIONS - See Intrinsics Hanual 

P4 » Record Size 

P5 * Block Size 

P6 • • Of Buffers 
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Event -63 (-177) 



FURITE 



EVENT NAHE: 

DESCRIPTION: 

CALLING NODULE: FILEIO 

CALUNG PROCEDURE(S): FURITE 

Paraneter Description 

P1 « File « 

P2 « TCOUNT - See Intrinsics Hanual 

P3 « FLAGS - (15:1) Buffer Hit Flag 



Event -64 (-Z100) 



FRERDDIR 



EVENT NRI1E: 

DESCRIPTION: 

CALUNG (tODULE: FILEIO 

CALLING PROCEDURE(S): FRERDDIR 

paraneter Description 

P1 = FiJe tt 

P2 = RC5TL0G - Trar.'er Count 

P3 « FLAGS - (1E:1) Buffer Hit flag 

P4 * REC N - 1SU 

P5 * REC N - LSU 

P6 = Not Used 
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Event -61 (-X75) 

EVENT NRRE: FOPEN' 

DESCRIPTION: NEU DISC FILE OPEN (CONTINUATION OF EVENT -60) 

CRLUNG nODULE: FILERCC 

CALUNO PROCEDURE(S): FOPEN 

Paraneter Description 

P1 « FCB File Unit 

P2 « FCB tlax I Extents 

P3 * (0:8)= Initial Allocation Extents 

P4-P6 - Not Used 



Event -62 (-Z76) 



FRERD 



EVENT NRHE: 

DESCRIPTION: 

CRLUNG HODULE: FILEIO 

CRLUNG PROCEDURE(S): FRERD 

Paraneter Description 

P1 « File I 

P2 ■ RCBTLOG - Transfer Count 

P3 • FLAGS - (15:1) Buffer Hit Flag 
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Event -65 (-1101) 




EVENT NRnE: 


FURITEOIR 


DESCRIPTION: 




CALUNG nODULE: 


FILEIO 


CRLUNG PROCEDURE: 


FURITEDIR 


Pf«»*1trJi!£EifiXiE 


I 



PI • File • 

P2 • TCOUNT - See Intrinsics Hanual 

P3 * FLAGS • (15:1) Buffer Hit Flag 

P4 « REC I - HSU 

P5 • REC • - LSU 

P6 • Not Used 
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£v t nt -66 (-110?) 

EVEMT NRRE: FUPDATE 

DESCRIPTION: 

CALUNG RODULE: FILflO 

CALUNG PROCEDURE(S): FUPOflTE 

Paraneter Description 

PI » Filt N 

P2 • TCOUNT - See Intrinsic! Ranual 
P3 * FLAGS - (15:1) Buffer Hit Flag 
P4-P6 - Not Usid 



Event -67 (-1103) 



IOURIT 



EVENT NRRE: 

DESCRIPTION: 

CRLUNG nODULE: FILEIO 

CALLING PROCEDURE(S): IOURIT 

Paraneter Descriotien 

P1 ■ File I 

P2 - RCBTLOG - TRANSFER COUNT 

P3 « FLAGS - (15:1) Buffer Hit Flag 
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nnSTRTS Events 
MSTRT Evnt Gmun 7 (FILESVS) 
These events are for development use only and are not nornally enabled. 



Event -70 (-1106) 



FPOINT 



EVENT HARE: 

DESCRIPTION: 

CALUNG HOOULE: FILEIO 

CALUNG PROCEDURE(S): FPOINT 

Paraneter Detcriotion 

PI ■ File i 

P2 ■ REC I - RSU 

P3 • LSU - LSU 
P4-P6 - Not Used 



Evnt -71 (-1107) 



FCONTROL 



EVENT RARE: 

DESCRIPTION: 

CALLING HODULE: FILEIO 

CALUNG PROCEDURE(S): FC0N1R0L 

Paraneter Description 

P1 > File • 

P2 ■ Code - See Intrinsics Hanyal 

P3-P6 - Not Used 
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Event -68 (-Z104) 

EVENT NRRE: 
DESCRIPTION: 
CRLUNG nODULE: 



FRERDSEEK 



FILEIO 



CRLUNG PROCEDURE(S): FRERDSEEK 

Parameter Description 

P1 * File N 

P2 « FLAGS - (15:1) Buffer Hit Flag 

P3 * REC R - RSU 

P4 « REC » - LSU 

PS-P6 - Not Used 



Evant -69 (-1105) 



FSPRCE 



EVENT NRRE: 

DESCRIPTION: 

CALLING nODULE: FILEIO 

CALLING PRQCEDURE(S): FSPRCE 

Paraneter Description 

P1 » File • 

P2 « DISPLRCEHENT - See Intrinsics Hernial 
P3-P6 - Not Used 
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HHSTRTS Evcnte 
Event -72 (-Z110) 



FSETIWOC 



EVENT NRRE: 

DESCRIPTION: 

CALLING RODULE: FILEIO 

CALLING PROCEDURE(S): FSETRQOE 

PI - File • 

P2 > R0DEFLR6S - See Intrinsics 

P3-W - Not Used 

Event -74 (-1112) 

EVENT NRRE: FCHECK 
DESCRIPTION: 

CRLUNG RODULE: FILEIO 

CRLUNG PROCEDURE(S): FCHECK 

PrHHf r PWaHaM 

PI • File • 

P2 « ERRORCOOE - See Intrinsics 

P3-P6 - Not Used 
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Event -7$ (-111?) 

EVENT NfiflE: FGETINFO 

DESCRIPTION: 

CRLUNG nCDULE: FILEIO 

CALLING PROCEOURE(S): FGETINFO 

Paraweter Description 

P1 * Filt II 

P2 * FOPTIONS - Sec Intrintict Hernial 
P3 - ROPTIONS - See Intrinsic* Hernial 
P4-P6 - Not Used 



Event -76 (-1114) 



FREROLRBEL 



EVENT NRHE: 

DESCRIPTION: 

CALLING nODULE: FILEIO 

CRLUNG PROCEDURE(S): 

Paraweter Description 

P1 « File « 

P2 ■ TCOUNT - Sec Intrineice Hernial 

P3-P6 - Not Used 



ntlSTRTS Events 

Event -77 (-1115) 

EVENT NRHE: 
DESCRIPTION: 
CRLUNG nODULE: 



FURITELR8EL 



FILEIO 



CRLUNG PROCEDURE (S): FURITELRBEL 

Paraweter Description 

P1 « File » 

P2 » TCOUNT - See Intrinsics nanual 

P3-P6 - Not Used 



Event -78 (-Z116) 



FLOCK 
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EVENT NRHE: 

DESCRIPTION: 

CRLUNG nODULE: FILEIO 

CRLUNG PROCEDURE(S): FLOCK 

Paraweter Description 

P1 « File ft 

P2 * LOCKCOND - Sec Intrinsics runuel 

P3 • COND CODE - Sec Intrinsics Hernial 
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Event -79 (-1117) 



MSTRTS Events 



Event -81 (-Xlfl ) 



FUN LOCK 



EVENT NRHE: 

DESCRIPTION: 

CRLUNG nODULE: FILEIO 

CRLUNG PROCEDURE(S): FUNLOCK 

Paraneter Description 

P1 * File ft 
P2-P6 - Not Used 



FCLOSE 



EVENT NRHE: 

DESCRIPTION: 

CRLUNG RODULE: FILERCC 

CRLUNG PROCEDURE(S): FCLOSE 

Parser Pcjcriptjon 

P1 * File It 

P2 ■ OISP - Sec Intrinsics nanuil 

P3 = SECCODE 



nnSTRT Event Greuo 8 (FILESVS/Cachine) 



Event -80 (-Z120) 



FRENRHE 



EVENT NRHE: 

DESCRIMION: 

CRLUNG nODULE: FILERCC 

CRLUNG PROCEDURES): FRENRnE 

Paraweter peee^p^on 

P1 = File i 
P2-F6 • Not Used 
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P4-P6 - Not Used 
Event 82 (Z122) 

EVENT NRflE: 

DESCRIPTION: 
CRLUNG HODULE: 



AURKEDCV 



RURKES I/O DEVICE H0NI7I 
KERNELC 



t UHEN SEGflENT FETCH COnPLETES 



CRLUNG PROCEDURE(S): PROCESSSCHEDnSG.UNOEFEROBJSHPQ 

Paraweter Description 

P1 * SYSD8 RELATIVE DIT POIN T ER OF LDEV TO 9E RURKENED 

P2 ■ UORO (FLRGS UORD) OF THE DIT OF THE LDEV TO BE RURKENED 

P3 • IF ORTR OBJECT THEN IOQ OR DRQ INDEX OTHERWISE LDEV NUHBER 

P4-P6 - Not Used 
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Event 83 (1123) 

EVENT NAHE: 
DESCRIPTION: 

CALLING HODULE: 
CALQNG PROCEDURE(S): 

Pa nutter Detcriotion 

P1 s CDT topped Donain entry 
P2 » LDR Entry Index 



STRATEGY 



CALLEO TO OETERHINE THE TYPE OF STRATEGY USED 
BASED ON UHO THE CALLER OF COT'ATTRCHIO IS 



CRCKESEG 
CDT' STRATEGY 



P3 « 



Strategy 

- Unknoun Caller 

1 - Unknoun Fron File Sytten 

2 - Spooler 

3 - Directory 
4-7 - Unknoun 

8 - GENHESSAGE 

9 - File Sytten, Quietce I/O 

10 - File Syeten, Sequential, NOBUF 

11 - File Sytten, Direct, NOBUF 

12 - File Sytten, Sequential, BUF 

13 - File Sytten, Direct, BUF 

14 - File Sytten, KSAF1 

15 - File Sytten, MAGE 

P4-P6 - Not Uted 
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IHISTATS Eventt 



Event 86 [%W) 

EVENT NRflE: 
DESCRIPTION: 
CALLING nODULE: 



COT.ATT 

CALLED FROfl CDT'ATTACHIO 

CRCKESEG 



CALLING PROCEDURE(S): CDT'ATTACHIO 

Paraneter Detcriotion 

P1 * Ldev 

P2 * Function 

P3 • Flagt 

P4-P5 » Pam1, Pam2 

P6 « Count 



Event 87 (X1?7? 

EVENT NflHE: 
DESCRIPTION: 
CALQNG HODULE: 
CALLIHG PROCEDURE: 

Parameter Description 



nRPJOfl 

CALLED UHEN NEED TO "HAP" A OISC 

CACHESEG 

CD!' MP' CACHED' DOHAIN 



P1 - Neu CDT En* ry Nunber 
P2 « Returned CDT Entry 
P3-P6 - Net Uted 



nnSTATS Eventt 

Event 84 (1124) 

EVENT NflHE: 
DESCRIPTION: 



INITIATE 

CALLED UHEN STARTING/COflPLETIHG LOGICAL DISC 
REQUEST 



CALLING HODULE: CRCHESEG 

CALLING PROCEDURE(S): COT* INITIATOR, COT'COflPLETOR 

Paraneter Detcriotion 

PI * COT napped Oonain Entry Nunber 
P2 » LDR Entry Index 

P3 » Type 

* Initiator 

1 - Conpletor 

P4-P6 - Not Uted 

Event 85 (1125) 

EVENT NflHE: 

DESCRIPTION: 

CALQNG HODULE: KARDRES 

CALQNG PROCEDURE(S): SIOOH 
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nnSTATS Eventt 

EVENT KRffE: 
DESCRIPTION: 

CALQNG RODULE: 
CALQNG PROCEDURE: 

Paraneter Detcriotion 

PI ■ CDT Ldev Entry Nunber 
P2 ■ Region COT Entry Nunber 
P3-P6 - Not Uttd 



UNJWPJW 

CALLED UHEN DISC DOflAIN NO LONGER HAPPED. (I.E., BOTH 
THE LOGICAL AND PHYSICAL I/O IS COHPLETE) 

CACHESEG 

CDT' BAP'CACHED' REGION 
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QNK.REG 

CALLED UHEN A DISC DOflAIN GETS LINKED INTO THE 
LINKED QST OF WAINS FOR AN LDEV 

CACHESEG 

QNK'CACHEO'REGION.UNQNK'CACHED'REGION 



Event 89 (1131) 

EVENT NAnt: 
DESCRIPTION: 

CALLING HODULE: 
CALQNG PROCEDURE: 

PfTt"Hr Pfflrlgtig" 

PI ■ Type 

* Link 

1 • Unlink 

P2,P3 * Rddrett Of Region Bate 

P4 * CDT Entry Nunber Found In The Header 

PS ■ • Of Paget 

P6 - Not Uttd 
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flflSTRT Event Group 9 (Disc I/O Requests) 



Event 90 K132) 

EVENT NfiflE: 
DESCRIPTION: 

CALUNG f100UL£: 
CALUNG PROCEDURE: 



REQCRCHE 



CALLED TO SEE IF CRCHING UILL ACCEPT THIS 
I/O REQUEST 



CACHESEG 
REQUEST' CRCHE 



Paraneter DetcriDtion 

P1 s LDR Entry Index 
P2-P6 - Not Used 

Event -98 (-Z142) 



EVENT NRHE: 
DESCRIPTION: 
CRLUNG nODULE: 



DISK TRAFFIC 

DISC I/O REQUEST KRS BEEN QUEUED 

HRRDRES 



CALLING PROCEDURE(S): ATTACHIO 



Paraneter Description 



P1«CMT 



Data Transfer Count: Words If >0; 
Bytes If <0 



P2«FLAGS.(0:4) 

P3»FNCT «0 « Read 
«1 « Urite 
*2 ■ Open File 
■3 * Close File 
«4 * Close Device 



nnSTRTS Events 



Event 100 (Z144) 

EVENT NflflE: 
DESCRIPTION: 
CALUNG nODULE: 



nnSTRT Evtnt Group 10 (Disc Errors) 



DISK ERROR 
RECORD DISC ERROR 
I0FDISC1 



CRLUNG PROCEDURE(S): FHDDVR 

Parameter Description 

P1 = OIPT(DSTRT) - Harduart Status 

P2 = SO - QHISC 

P3 * IOQP(QLDEV).QLDEVN LOR ST0C0UNT&LSL(8)) * DEV/SIO Prog ran Counter 

Event 101 (Z145) 

EVENT NRHE: DISK ERROR 

DESCRIPTION: RECORD DISC ERROR 

CRLUNG nODULE: IQHDISCO 

CRLUNG PROCEDURE(S): flHDDVR 

Parameter Description 

PI > DIPT(DSTAT) - Harduart Status 

P2 ■ SO - Qnisc 

P3 * I0QP(QLOEV).QLDEVN LOR ST0C0UNT&LSL(8)) 
* LDEV/SIO Prog ran Counter 
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nriSTATS Events 



Event -110 (-1156) 

EVENT NAflE: 
DESCRIPTION: 
CRLUNG ItOOULE: 



nnSTRT Evtnt Group 11 (SIO) 



START I/O 

DRIVER INITIATOR FOR SIO DEVICE HAS BEEN CALLED 

HARDRES 



nnSTAT Event Group 12 (Disc Space) 



Event 120 (2170). 




EVENT NRRE: 


SOFT' DEATH 


DESCRIPTION: 


BUG CATCHER 


CRLUNG nODULE: 


HRRDRES 



CRLUNG PROCEDURE(S): SIODfl 



Paraneter Description 



PI * IOQPL(QSTAT) LOR IOQPL(QLDEV).LDEVH 

* (0:8) PCB Entry ft Of Process flaking Request 
« (8:8) Logical Device Nunber Of Device For I/O 

P2 « IOQP(QUBCT)«llord Count If>0;Byte Count lf<0 

P3 « (0:2) * Function Code Specified By Driver 
« « Read 
• 1 ■ Urite 
« 2 ■ Control 
« (6:10)* DSTN Of Target Data Stg 



Eveni -111 (-X1$7) 

EVENT NAflE: I/O COflPLETION 

DESCRIPTION: SIO COflPLETION 

CRLUNG flODULE: HRRDRES 

CRLUNG PROCEDURE(S): SIODfl 

Paraneter Description 

PI « IOQP(QLDEV).LDEVN*Logical Device Nunber Of Disc Involved In Transfer 
P2 * I0QP(QPRR1 ) - (Defined By Driver) 
P3 • I0QP(QPRR2) - (Defined By Driver) 
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CRLUNG PROCEDURE(S): SOFT' DEATH 

Paraneter Description 

P1 « SOFT'DERTH I.D. Nunber 
P2 * Caller's Status Register 
P3 * Caller's Delta P 

fttnj 125 (X17S) 

EVENT NRHE: IOBUFTRP 

EVENT DESCRIPTION: IOSYSTEfl BUFFER TRAP 

CRLUNG HODULE: HRRDRES 

CRLUNG PROCEDURE(S): SIODfl 

Paraneter Description 

P1 - IOOP 

P2 « I0Q?:30STN).DSTN * DST Nunber Of Buffer 

P3 « 
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Evtnt -130 (-Z202) 

EVENT NflnE: 

DESCRIPTION: 

CALLING nOOULE: HRRDRES 

CRLLINC PROCEDURE(S): RTTRCHIO 

Paranettr Deacnotion 

P1 , LDEV 
P2 ■ P Rtgitttr 
P3 = RSTRTUS 
P4-P6 - Not Uttd 

Event -131 (-Z203) 

EVENT NRHE: 

DESCRIPTION: 

CALLING nOOULE: HRRDRES 

CALLING PROCEDURES): RTTRCHIO 

Paranettr Detcrjption 

P1, P2 » Exttnt Baat 
P3 ■ Exttnt Silt 
P4-P6 - Not Uttd 
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RIISTRTS Evtntt 



ffllSTRT Evtnt Group 13 (Due Caching) 



CJBSENT 

EITHER THE RRPPED DISC DORRIN OR THE TRRGET 
DST URS ABSENT UHEN R CACHE ROVE UAS ATTERPTED 

CACHESEG 

PROCESSCDTLOGREQQUEUS 



Evtnt 139 (1213) 

EVENT NRRE: 
DESCRIPTION: 

CALLING RODULE: 
CALLING PROCEDURE: 

Paranettr Dttcriotion 



PI » (Upstd Dontin Abttnt 

P2 « Pin 

P3.P4 * Stgntnt Idtntifitr Of Rtpptd Dontin 

P5-P6 - Not Uttd 

PI « LDR Entry Index (DST Not Prtttnt) 

P2 ■ Pin 

P3.P4 • Stgntnt Idtntifitr Of DST (P4.(0:1) > 1 Stack) 

PS-P6 - Not Uttd 
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nnSTRTS Evtntt 




Event -132 (-2204) 




EVENT NRRE: 




DESCRIPTION: 




CALLING nODULE: 


HRRDRES 


CRLLINC PROCEDURE: 


RTTRCHIO 


Paraneter Description 





S*^*\ 



P1, P2 » Fomal Paranetert Given To ATTRCHIO Uhich Art Deviet 
Dependent Paraneten 

P3 * Foniai. FLAGS Parantter Supplied To RTTRCHIO By Tht Calitr 

P4-P6 - Not Uttd 
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Event 140 (1214) 

EVENT NARE: 
DESCRIPTION: 
CALLING RODULE: 



RRSTAT Evtnt Group 14 (CS/3000) 



COPEN 



C0RSYS2 



CALLING PROCEDURES): COPEN 

Partwttl'- pttcrjptjon 

P1 * (0:8) ■ CS Error Codt 

« (8:8) « Logical Dtvict Nunbtr 

P2 ■ PRAP1 

P3 • PRRP2 



lW\ 1«2 Wtt 



CRBORTIO 



EVENT NARE: 

DESCRIPTION: 

CRLUNG RODULE: COTSYS1 

CRLUNG PROCEDURE(S): CRBORTIO 

Parantter Description 

P1 * logical Device Nunber 
P2 * IOCINDEX 
P3 * 



k 
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nnSTRTS Evtntt 


(inSTRTS Evtntt 


M 144 (Z220) 


Evtnt 147 (X223) 


EVENT NAflE: CSIOUAIT 


EVENT NAflE: CRERD 


DESCRIPTION: 


DESCRIPTION: 


CRLQNG HOOUl£: CONSYS1 


CALLING nODULE: C0HSYS4 


CRLQNG PROCEDURE(S): CSIOUAIT 


CALQNG PROCEDURE(S): CRERO 


Paranettr Dttcriotion 


Parantttr Oescriotion 


PI * (0:8) * CS Error Codt 

s (8:8) * Logical Dtvict Nunbtr 


P1 * (0:8) - CS Error Codt 

(8:8) = Logical Dtvict Nunbtr 


P2 « Trananittion Log 


P2 * INCQUNT 


P3 


P3 * STATION 


Evtnt 146 (Z222) 


Evtnt 149 (Z225) 


EVENT NRHE: CCLOSE 


EVENT NAflE: CURITE 


DESCRIPTION: 


DESCRIPTION: 


CALQNG nODULf: C0I1SVS3 


CRLQNG RODULE: C0NSYS4 


CALLING PROCEDURE(S): CCLOSE 


CRLQNG PROCEDURE(S): CURITE 


Parantttr Dttcriotion 


Parantttr Dttcriotion 


P1 (0:8) * CS Error Codt 

(8:8) » Logical Oevict Nunbtr 


P1 ■ (0:8) « CS Error Codt 

* (8:8) * Logical Dtvict Nunbtr 


P2 « Lint Ntmotr 


P2 » OUTCOUNT 


P3 «0 


P3 « INCOUNT 
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(tnSTRTS Evtntt 


nnSTRTS Evtntt 


nnSTAT Event Grouo 15 (CS/3000) 


Evtnt 153 (Z231) 


fvtnt 1?0 (Z?26) 


EVENT NRItE: COPENTRACEFILE 


EVENT NfiflE: CSDRIVER 

DESCRIPTION: 

CALLING NODULE: BSCLCH 


DESCRIPTION: 

CRLQNG NODULE: 

CRLQNG PROCEOURE(S): COPENTRACEFILE 


CALQNG PROCEDURE(S): CSDRIVER 


Parantttr Dttcriotion 


Parantttr Dttcriotion 


P1 * (0:8) « CS Error Codt 

• (8:8) * Logical Otvict Nunbtr 


P1 « TIBER - LSU 


P2 « CTRACEINFO 


P2 * CURRENTSTRTE - Uhtrt Tht Drivtr Is In Tht Statt Trantitlon Tablt 


P3 » 


P3 « CURRENTEVENT - (0:8) > Current Evtnt 

(8:8) > Logical Dtvict That Cauttd Tht Drivtr To 
Btcont Rctivt 


Evtnt 154 (Z232) 


gvtnt 15,2 (Z?30) 


EVENT NRtlE: CCLOSETRACEFItf 
DESCRIPTION: 


EVENT NRflE: CCONTROL 


CRLQNG NODULE: 


DESCRIPTION 


CRLQNG PROCEDURE(S): CCLOSETRACEFILf 


CALLING NODULE: COnSYSS 
CALQNG PROCEDURE(S): CCONTROL 


P««BtirJl«rtPttOT. 


Pj«\«nR!«C Dttcrtftion 


P1 * (0:8) * CS Error Codt 

» (8:8) « Logical Dtvict Nunbtr 


PI « (0:8) « CS Error Codt 

« (8:8) « Logical Dtvict Nunbtr 


P2 • 
P3 « 


P2 » Control Codt 




P3 « Parantttr 


„ 
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Event 155 (1233) 

EVENT NAHE: CPOLUST 

DESCRIPTION: 

CALLING nODULE: 

CALLING PROCEDURE(S): CPOLUST 

Parantter Description 

P1 * Logical Oevice 
P2 * CS Error Code 
P3 s PRAP 
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RRSTRT Event Groun 19 (Due Controller Introt) 



nnSTRTS Events 



fre^ 191 (1^77) 

EVENT NARE: 
DESCRIPTION: 



DISKINTRPT 

R 7905/7920 CONTROLLER IS PROCESSING RN ATTENTION 
INTERRUPT (ONLINE/OFFLINE) 



CALLING ItODULE: KARORES 

CALLING PROCEDURE(S): SIODfl 

Paraneter Detcriotion 

P1 > IOITP - (US) - (i.e., Uho Got The Interrupt) 

P2 « IDITP - (THEII) - (i.e., Uho Ren The Poll Progran) 

P3 « DITP - "OUT DIT Flags Uord 

There should be at least an 1300 and an Z303 for each SIO PRGfl. 
A single isolated (in tine) request uill generate at least a 
2303, Z300, Z303. If the queue of IOQ'S on a DIT never enpties, 
there would be one Z300 and one Z303 per SIO PRGfl. 
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HBSTRT Event Group 16 fCS/3000) 



Event 160 (Z240) 

EVENT NAHE: CRERD 

DESCRIPTION: 

CALLING nODULE: DSnON 

CALLING PROCEDURE(S): 

Paraneter Description 

P1 « Tine Stanp 

P2 * (0:4) Not Used 
(4:1) Block 
(5:2) State 
(7:3) Next 
(10:1) :«0 Initialization Event 

:«1 Conpletion Event 
(11:5) Sub Event Nunber 

P3 * Depends On The Sub Event Nunber Rnd 

If It Is An Initialization Or Conpletion Event 
RSG: (0:4) STRRTYPX 

(4:6) RSG CLS 
(10:16) STRnTYP 
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Event 192 (Z300) 

EVENT RARE: 
DESCRIPTION: 
CALLING rtODULE: 



GIPINTERRUPT 

INTERRUPT JUST PROCESSED 

KARDRES 



^PHv 



SUB EVENT 


SUB EVENT 


INIT 


CORP 


NO. 


NRRE 


PRRA 


PARR 





CRERO 





LEN 


1 


CURITE 


X NSG 


LEN 


2 


IOUfllT 





LEN 


3 


CCKECK 





ERRCOO 


4 


DSRTTN 








5 


DSUC 


x n$G 


RHSG 


6 


CKNGEURIT 


PRRR 





7 


nONREQ 


REQ 





10 


CABORT 





T/F 


11 


CRESET 








12 


CSDATA 


R RSG 




13 


CSRERERD 







CALLING PROCEDURE(S): GIP 

Paraneter Description 

P1 • LDEV 

P2 * Queue Elenent Uord Entry Index 

P3 > Contents Of DIT Uord 0: The Flags Uord 

P4 * Channel Progran Instruction Pointer 

P5 * Controller Status 

P6 « LSU of a Return fron TIRER 

Event 193 (Z301) 

EVENT NRRE: STARTIO 

DESCRIPTION: ISSUING SIOP RRCHINE INSTRUCTION 

CALLING RODULE: HARDRES 

CALLING PROCEDURE(S): STRRT'HPIB, STARTIO 

Partner Description 

P1 ' Rbsolute Address Of SIO Progran To Start 

P2 « LDEV Ninber 

P3 * ORT Nunber 

P« » Q' ENTRY' INDEX Fron DITP(DIOQP) 

P5 « DIT Uord 0: The DIT Flags Uord 

P6 » LSU Of A Return Fron A Call To TIlfER 

G.23.00 
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MSTRTS Evtnts 



Evtnt 194 (Z302) 

EVENT NRHE: SIODH-ENTRY 

OESCRIPTIOM: ENTERING SIODfl 

CALLING HODULE: HARDRES 

CALLING PROCEDURE (S): SIQOH 

Paraneter Description 

P1 * LDEV 

P2 * IOQ OR DRQ Table Relative Index 

P3 * OIT Uord (OIT FLAGS) 

P4 * Current State Of Tht Variable State In SlOOfl 

P5 * Not Used 

P6 » LSU Returned By Call To TinER 

Event 195 (Z3Q3) 

EVENT NRnE: SIODH-EXIT 

DESCRIPTION: LEAVING SIODH nAlN LOOP 

CALLING HODULE: KRRDRES 

CALLING PROCEDURE(S): SIODH 

Paraneter Detcrjpticn 

The aane at Event 194 (X302), above. 
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MSTRTS Events 

HHSTAT Event Group 20 (Private Volunes) 

Theee Events are for developnent use only and are not nomally enabled. 

Event 200 (1310) 

EVENT NRnE: DISKBUGCRTCHER 

DESCRIPTION: R HOUNTED VOLUHE TABLE CHANGE IS BEING HADE. 

CRLQNG flQDULE: PVSYS 

CALLING PROCEDURE(S): nVTRBLE 

Paraneter Description 

P1 « FUNCT 

* Oelete Entry 

1 * Add Entry 

2 » Preserve Entry 

P2 « HVTABX (noun ted Volune Table Index) 
P3 = DELTAP (Value Of Q-2) 
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Event 201 (1311) 

EVENT NAHE: 
DESCRIPTION: 
CALLING flODUlE: 



DISKBUGCRTCHER 

A PRIVATE VOLUttE USER TABLE CHANGE IS BEING RAOC. 

PVSYS 



CALLING PROCEDURE(S): USERTRBLE 
Paraneter Description 

P1 * FUNCT 

* Create User Entry 

1 s Renane User Entry 

2 * Return fill W1ABX Ind.cn Used By A 

Specific PCB 

3 = Return All PCB Pointers Using A Specific 

HVTABX 

4 s Get User Entry 

P2 * RVTABX (Houn ted Volune Table Index) 
P3 * DELTAP (Value Of Q-2) 



nr.STRT Event Troup 21 (Process Creation And Temination) 



Event -211 (-Z??3) 

EVENT NAHE: 
DESCRIPTION: 
CALLING MODULE: 



PROCESS CQHPLETION 
PROCESS HAS TERHINATEO 
nORGUE 



nnSTATS Events 

HHSTAT Event Group 22 (Honitor Confjg Information) 

Event 221 (I33S) 

EVENT NRnE: CONFIGURATION INFORflRTION 

DESCRIPTION: EVENT GROUP I1ASK 

CALLING HODULE: CRIO 

CALLING PROCEDURE(S): CONSHON 

Paraneter Description 

PI * HERSnSKO 
P2 * HEASnSKI 
P3 ' Reserved 



CALLIHC PROCEDURE(S): TERilNATE 

Farantter Description 

P1 » 
P2 - 
P3 « 
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HHSTRTS Evtntt 



gv^ 111 mm 

EVENT NRHE: CONFIGURATION INFORHATION 

DESCRIPTION: HPE VERSION FIX UPDRTE 

CALUNG HOOULE: OPCOrHIAND 

CALUNG PROCEOURE(S): CXHON 

Paraneter Ot teription 

P1 * Vertion 
P2 « FIXL 
P3 * UPORTEL 

Evtnt -223 (-1337) 

EVENT NAHE: 
DESCRIPTION: 



CONFIGURATION INFORnRTION 



SYSTER TABLE LOCATIONS RND RVRILRBLE UNKED nEHORY 
INFORHRTION 



CRLUNG nODULE: QPCOHHRND 

CALLING PROCEDURE(S): CXHON 

Paraneter Detcriotion 



PI ■ F (Z1032)*#CST(0)-#DST(0) -Ditplacenent To Code 

P2 > F(Z1033)««CST(LAST)-€DST(0) Oitplacenent To Sharablt 

P3 ■ L0GICRL(T0TRL40LSK(4))*Unktd Henory Size 
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SYSPINS 

LOGICAL PROCESS TRBLE 

OPCOHHRND 



nnSTRTS Evtntt 

Evtnt -224 (-1340) 

EVENT NRHE: 

DESCRIPTION: 

CALLING nOOULE: 

CALLING PROCEOURE(S): CXnON 

Paraneter Description 

P1 * RBSOLUTE(Z1141)aPR0GEN , S PCB Entry Nunber 
P2 « RBS0LUTE(Z1142)«RRn , S PCB Entry Nunber 
P3 » RBS0LUTE(Z1143)=UC0P'S PCB Entry Nunoer 

Event -225 (-Z341) 



EVENT NRHE: 
DESCRIPTION: 
CRLUNG RODULE: 



SYSPINS(CNTD. ) 
LOGICAL PROCESS TRBLE 
OPCOHHRND 



CRLUNG PROCEDURE(S): CXHON 

Paraneter Detcriotion 

P1 « RBSOLUTEtfU^PFRIL'S PCB Entry Nunbtr 
P2 « RBS0LUTE(Z1145)-DEVREC»S PCB Entry Nunbtr 
P3 ■ RBS0LUTE(Z1146)«PRnSG'S PCB Entry Nunbtr 
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MSTRTS Evtntt 



E*m -iff <-n«tt 

EVENT NRHE: SYSPINS(CNTO. ) 

DESCRIPTION: LOGICAL PROCESS TRBLE 

CALLING RODULE: OPCOHHRNO 

CRLUNG PROCEOURE(S): CXHON 

PfWtr Pffcrjptton 

PI * R8S0LUTE(Z1147)s$TnSG'S PCB Entry Nunbtr 
P2 • RB$OLUTE(Z11SO)*L0G'S PCB Entry Nunbtr 
P3 « RBS0LUTE(Z1151)*L0RD'S PCB Entry Nunbtr 

Evtn^ -$27 (-Z343) 

EVENT NRHE: SYSPINS(CNTD.) 

DESCRIPTION: LOGICRL PROCESS TABLE 

CRLUNG HODULE: OPCOnnRND 

CRLUNG PROLEDL'PEC): CXHON 

Parantter Detcriotion 

PI » RBSCwL'TEUH52)«IDnESSPR0C , S PCB Entry Nunbtr 
P2 » RBSOLUTEiZl^a/sSYSIOPROC'S PCB Entry Nunbtr 
P3 * ABSOLUTE^ 1 WsHEHlCGP'S PCB Entry Nunbtr 



HHSTRTS Evtntt 




Evtnt -228 (-Z344) 




EVENT NRHE: 


TIHESTRHP 


DESCRIPTION: 


TIHESTRHP 


CRLUNG RODULE: 


OPCOHHRND 



CRLUNG PROCEDURE(S): CXHON 



Parantttr Dtteriotion 



P1 "CALENDAR (0:7) « Ytar Of Ctntury 

(7:9) « Day Of Ytar 

P2«CL0CK(UOR01).(O:7) • Hour Of Day 

(8:8) > Hinutt Of Hour 

P3«CL0CK(UOR02).(O:7) • Stcondt Into Hinutt 

.(8:8) « Ttntht Of Stcondt 



Hit •«? (-*W 

EVENT NRHE: HGNOFF 

DESCRIPTION: END EVENT TRACING 

CRLUNG HODULE: OPCQRHflNO 

CRLUNG PROCEDURE(S): CXHON 

Parantttr Dtteriotion 

P1 «0 
P2 -0 
P3 > 
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MSTRTS Event* 



mr \ 



^PK 



wnSTflT Event Group 23 (Terninal I/O) 



TERHRERD 

TERMNRL READ CQItPLETION 

KRRORES 



Event 230 (1346) 

EVENT NfiflE: 

DESCRIPTION: 

CALQNG nODULE: 

CALQNG PROCEOURE(S): TIP 

Paraneter Description 

P1 * LDEV 

P2 » Read Duration 

P3 « Bytes Read 

Event 231 (1347) 

EVENT NfiflE: 

DESCRIPTION: 

CALQNG nODULE: 

CALQNG PROCEDURE(S): TIP 

Paraneter Description 

P1 « LDEV 

P2 ■ Duration (Betuttn Start Rnd DC 2) 

P3 ■ Bytes Read (Excluding DC 2) 



DC1DC2ACK 

DC1/DC2 KRS BEEN SATISFIED 

KRRDRES 
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Event 234 (X3S2) 

EVENT NRttE: TEMLOGuH 

DESCRIPTION: TERMNRl JUST LOGGING ON 

CflLQNG RQDULE: IOTERflO 

CRLUNG PROCEDURE(S): TERMOR 

Paraneter Dateriotion 

P1 « LDEV 
P2 »0 
P3 «0 

Event 235 (2353) 

EVENT NRItE: TERALOGOFF 

DESCRIPTION: TERMNAL JUST LOGGED OFF 

CALLING nOOULE: IOTERHO 

CflLQNG PROCEDURE(S): TERMOR 

Parameter DeicriPticn 

P1 • LDEV 
P2 « 
P3 • 
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Event 232 (1350) 

EVENT NRItE: TERNURITE 

DESCRIPTION: URITE COnPLETION 

CflLQNG nODULE: IOTERKO 

CflLQNG PROCEDURE(S): TERMOA 

Paraneter Description 

PI * LDEV 

P2 * o 

P3 s Byte Count Of Transfer 



Event 233 (Z35D 

EVENT NAHE: 
DESCRIPTION: 



CRLQNG NODULE: HRRDRES 
CRLQNG PROCEDURE(S): TIP 



Paraneter Description 

P1 * LDEV 
P2 * Duration 
P3 ■ Bytet Read 



BINRERD 

BINARY RERD COKPLETED 
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ftnSTRTS Events 

Event 236 (Z3S4) 

EVENT NRRE: 
DESCRIPTION: 
CRLQNG NODULE: 



SPECCKRR 

PROCESSED SPECIAL CHARACTER 

KRRDRES 



CRLQNG PROCEOURE(S): TIP 

Paraneter Deecriotion 

P1 « LDEV 

P2 * Special Character Processed 

P3 «0 

Event 237 (Z355) 

EVENT NRNE: BRERK 

DESCRIPTION: PROCESSED BRERK 

CRLQNG nODULE: KRRDRES 

CflLQNG PROCEDURE(S): TIP 

Parareter Description 

P1 « J)EV 
P2 • DSTRTE 
P3 « 
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RRSTRTS Evtnts 



gvffit ?38 (135$) 

EVENT NflflE: 

DESCRIPTION: 

CALLING nOOULE: 

CALLING PRCCEDURE(S): TIP 

Paraneter Description 

PI * LDEV 
P2 * Duration 
P3 » BCNT 



SPECRERD 

SPECIAL RERD TERRINATION CHRRRCTER DETECTED 

HRRDRES 
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nnSTRTS Evtnts 



Event -241 (-1361) 

EVENT NRRE: 
DESCRIPTION: 
CALLING RQDULE: 



PSEUDOINT 

PSEUDO/S0FT INTERRUPT NRNOUNG 

RISCSEGC 



CRLUNG PROCEDURE(S): PSUEDOINT 



Paraneter Description 



P1 ■ Inttrrupt Typt 

* If Hard Kill (P2, P3 Not Uttd) 

* 1 If Soft Kill (P2, P3 Not Utid) 

* 2 If Control- Y (P2, P3 Not Uttd) 
« 3 If Break (P2, P3 Not Uttd) 

* 4 If Sytten Soft Inttrrupt 

P2 « 
P3 « 

* 5 If Uttr Soft Inttrrupt 

P2 « 
P3 « 

P2, P3 « Dependent on P1 

P4, P5, P6 - Not Used 
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nnSTRTS Evtntt 



Event ?40 (1360) 

EVENT NRRE: 
DESCRIPTION: 
CALLING nODULE: 



nnSTRT Event Group 24 (P ower fail) 



PFRIL 

POUER FRIL DETECTEO 

ININ, PFRIL 



CALLING PROCEDURE(S): POUERUP (ININ), POUERUP (PFRIL) 
Paraneter Degcriotion 

P1 « Called Fron Powerup In ININ 

1 Called Fron Entry In Pouerup In PFRIL 

2 Called Fron End Of Pouerup In PFRIL 

P * For P1«0 This It 
For P1*1,2: 

TRUE « Ruitiple Pouerfail 
FALSE" First Pouerfail 



P3 * PF 

1 
2 
3 
4 



* No Pouerfail Or PFRIL Processing Conplete 

* Set By The Pouer Doun Trap In ININ 

* Set By The Pouer Up Trap In ININ 
« Stt linen Ruake The PFRIL Procett 

* Set By PFRIL Rfttr fleetest Rpptart On Contolt 



P4 « SYSUP 

« Sytttn Not Back Up Rfttr Pouerfail 

1 « Sytttn Back Up Rfttr Pouerfail 

P5-P6 - Not Uttd 
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CHAPTER 21 ROOTFILE LAYOUT 
General Root file Layout 

| 

I 
LABEL | ROOTFILE INFORRRTION 
| (128 UORDS) 

|™~ 
1 | PRSSUORD TABLE 
L 

I 



2| PRSSUORD TRBLE (CONT.) 

I 

3 | ITER R/U TABLE 

I 



• 


SET R/U TRBLE I 


RECORD 


DATABASE GLOBAL INFO I 
(128 UORDS) I 


1 


ITER RAP I 
SET RAP | 


2 


ITER TABLE ! 
(VARIABLE SIZE) 1 




SET TABLE 1 
(VARIABLE SIZE) I 




DATA SET CONTROL BLOCKS I 

(DSC8) 1 

(VARIABLE S17 r ) | 




oev t :e cl«< table i 
(variable size) 1 
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Rootfile Layout 

The data bast ROOT FILE it an HPE filt uith filecode equal to -400. The 
record tize it 128 uords, fixed, binary fornat uith a blocking factor of 1. 
The size of the file dependt on the nunber of data itene and data tett 
defined in the data bate. 



Root File Label 



I 
0| 

I 
11 

I 
21 
31 

I 
41 

I 
51 

I 
61 

I 
71 

I 
101 
111 
121 
131 

I 

141 
151 
161 
171 

I 
201 

I 
211 

I 
221 
231 

I 
241 



Rl' CONDITION 


• (ROOTFILE CONDITION) 


RL'DATE 


(CREATION DATE) 
......... .............. j 


RL'TME 


(CRERTION TIRE) 
. ..... ....... — — 


RL'EVEROPEN 




RL'COLDLOADID 


- (COLD LORD ID) 



RL'USERCOUNT 


RL'OBG'NUn 


- (DBG DST NUH8ER) 

...... ..... ~ 


RL'LOGID - 
.......... 


(LOG ID FOR 
TRANSACTION LOGGING) 

. - — — 



RL'LOGPASS - (LOG ID PRSSUORD) 



18 

19 

110 

111 

I 

112 

113 

114 

115 

^tUFLAGS - (DATABASE FLAGS) 1 16 

~~|17 
I 

118 
119 
I 
1 20 



RL'STORDATE - 


(D8ST0RE DATE) 


RL'STORTME 


(DBSTORE TME) 
............. ... 


RL'BUFSPECCOUNT 
............. 


(BUFFER SPEC COUNT) 
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Rootfile Layout 

R 0a t File Label (Cont.) 

RL' CONDITION (IN ASCII): 

JB - Virgin. The database has not been created yet. 

FU - OX. The database is OK. 

Rfl - Aodified deferred. The database is being nodified. 

I1C - Haintenance create. The database is being created. 

HE - Haintenance erase. The database is being erased. 

IL - ILR recovery in progress. 

IE - ILR enable in progress. 

ID - ILR disable in progress. 

CN - Conversion by D8C0NV was in progress and cannot be 

continued. 
CA - Conversion by OBCONV uas in progrets and can be 

continued. 
fW • Database file nove is in progress. 

RL'DATE - Root file creation date*. The fornat is: 

0123456789012345 

I — I — I — I — I — I — I — I — I — I — 1 — 1 — I — I — 1 — • — ■ 

| YEAR I DAY OF YEAR I 

, 1 1 

RL'TME - Root file creation tine*. The fornat it: 

0123456789012345 
,..,..,..,..,..|.-|.-|~|~|~|~|--I--|--M--I 
| HOUR I HINUTES 

| SECONDS I TENTH OF SECONDS I 

RL'EVEROPEH - This field is no longer usfd under MAGE B 

RL'FLAGS - 

(0:1) - RECOVERY Default is NO (0) 
(1:1) - LOGGING Default is NO (0) 
(2:1) - ACCESS Default is YES (1) 
(3:1) - DUHPING Default is NO (0) 
(4:1) - OUTPUT DEFER Default is NO (0) 
(5:2) - SUBSYSTEH ACCESS Default is R/U (00) 
(7:1) - ILR Default is NO (0) 

(8:1) - ROLLBANK Default is NO (0) 
(9:1) - RESERVEO 
(10:1)- DIRTY FLAG Default is YES (1). 

This indicates the database has 
been nodified but not DBSTOREd. 
(11:1)- D8REC0V RESTART Oefault is NO (0) 
(12:4)- RESERVED 
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Rootfile Layout 



Root File Label (Cont.) 



I- 



— I 



25I RL'ILRCREATEDATE (DATE ILR LOG CREATED) 121 
I I 

26 1 RL'ILRCREATETME (TME ILR LOG CREATED) 1 22 
27| [23 

30 | RL'ILRLASTDATE (LAST LOG ACCESS DATE) |24 

| 1 

311 RL'ILRLASTTME (LAST LOG ACCESS TWE) 125 
321 126 

| 1 

331 RL'RBPREOATE (PREVIOUS ROLLBACK DATE) 127 
34| RL'RBPRETME (PREVIOUS ROLLBACK TIRE) 128 
351 129 

| 1 

361 RL'RBOATE (ROLLBACK DATE) 130 

| 1 

37| RL'RBTME (ROLLBACK TWE) 131 

40 1 __ 1 32 

41| RESERVED 133 

| 1 

42| RL' LANGUAGE' ID (LANGUAGE ID) 134 

| 1 

43| RL'LANG'flNEriONIC (LANGUAGE HNEHONIC) 135 



521 



531 RESERVED FOR DBCONV 



I- 
54] RESERVED 

77| 

I- 
1001 
1011 
1021 
1031 



FOR 



142 
-I 

143 
-I 

144 



FUTURE 



USE 



RL'nAINTUORD (DATABASE HAINTENANCE 
UORD) 



I- 



104| RL'BUFFERSPECS (BUFFER SPECIFICATIONS)]! 



163 

I 

164 

165 

166 

167 

I 

168 



1771 



1127 
-I 
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Rootfile Layout 

RoatFil, Label (Cont.) 

RL'STORDATE - Sane fornat as RL'DATE*. 

RL'STORTIflE - Sane fornat as RL'TWE*. 

RL'BUFSPECCOUNT - riaxinun nunber of buffer specifications allowed. 

RL'ILRCRERTEDATE - Sane fornat as RL'DATE*. 

RL'ILRCREATETinE - Sane fornat as RL'TWE*. 

RL'ILRLASTDATE • Sane fornat ae RL'DATE*. 

RL'ILRLASTTME - Sane fornat as RL'TWE*. 

RL'RBPREDATE - Sane fornat as RL'DATE*. 

RL'RBPRETME - Sane fornat as RL'TME*. 

RL'RBDRTE - Sant fornat as RL'DATE*. 

RL'RBTME - Sane fornat ae RL'TME*. 

RL' LANGUAGE' ID - Sane fornat ae defined in eyeten configuration. 

RL'LANG'IINEnONIC - Language ratenonic for thie database. 
flaxinun 16 charactere. 

RL'nAINTUORD - For data basee uith no naintenance uord thie field hat 
2 ttnicolons (';;') and trailing blanks. 

RL'BUFFSPECS - 

] 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I — I — I — I — I — I — I — I — 1 — • — I — I — I — I — I — ■ — I 

| 1041 BUFFERS FOR 1 USER I8UFFERS FOR 2 USERS__ |6t 

| 1051 BUFFERS FOR 3 USERS I BUFFERS FOR 4 USERS 169 
127| BUFFERS FOR 119 USERS IBUFFERS FOR 120 USERS |177 

* The DATE and TME fields can be fornatted (for dieplay purposes) 
individually by calling the FHTCALENDAR and FHTCLOCK Intrinsics 
respectively, or both fields can be fornatted at once uith FHTDATE 
intrinsic. 
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Roetfilt Layout 

Root Filt Labels 1 & 2 

Label 1 



UORD 0| PASSUORD FOR USER CLASS 

1| (THIS IS R DUMY FIELD SINCE USER 
21 CLASS IS NOT DEFINED) 



4 | PRSSUORD FOR USER CLASS 1 

51 

61 

71 

101 PRSSUORD FOR USER CLASS 2 
111 
121 
131 
| 



-IX 
10 

11 

12 
13 
1 

H 
15 
16 
|7 

1 

18 
19 
HO 
111 



174| PRSSUORD FOR USER CLASS 31 

1751 

1761 

177| 



I- 



-I 
1124 
1125 
1126 
1127 

-I 
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Rootfilt Layout 



Label 2 



UORD 0| PRSSUORD FOR USER CLASS 32 
II 
21 
31 



4| PASSUORD FOR USER CLASS 33 

51 

61 

71 

101 PASSUORD FOR USER CLASS 34 

111 

121 

131 

| 



-IX 
10 

n 

12 

13 
-I 

14 

15 

16 

17 
-I 

18 

19 

HO 

111 
-I 



174| PASSUORD FOR USER CLASS 63 

1751 

1761 

177| 



I- 



1124 
1125 
1126 
1127 
-I 



The Passuord Table occupies user labels nunber 1 and 2. There art four words 
(8 characters) reserved for each password. The relative position of a pass- 
word corresponds to the user class nunber defined in the schena. For user 
class nunbers not defined in the SCHEHA, the four uord field is filled uith 
blanks. 
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Rootfile Layout 



»99t nif l*ti ? 




101 ITEM RERD/URITE BIT I 
111 



171 



20| ITEM RERO/URITE 8IT I 
»1 

167| 

I— 

170| ITEH16 RERD/URITE BIT I 
1711 



177| 
I- 



115 



116 
117 



1117 
-I 
|120 
1121 



1127 
-I 



Rootfile Layout 



"991 fMt " "t«t l«W<» ? 



The Iten Read/Urite Table starts in user label »3. There are eight uords for 
each Iten Read/Urite bit nap. For databases uith nore than 16 itent, the 
Read/Urite table continues in the next user labels. The specific remit of 
this table is explained after the Set Read/Urite Table since it is defined 
the sane uay. The nunber of user labels occupied by the It.n Read/Unto 
Table depends on the nunber of data itsns defined in the schena and can be 
obtained by rounding upwards (ceiling) tht result of: 

Nun-of-labels ■ ((Nun-of-iten*)*8]/128 

Since there can only be a naximm of 1023 data itent in the schena, the naxi- 
nun size for this table in ussr labsls would be: 

(lax-size « [(1023)*8)/128 > 63.93 » 64 labels. 



6.23.00 
21- 8 




101 SET2 READ/URITE BIT BAP 
111 



171 



20| SET3 RERD/URITE BIT RAP 
211 



167| 

1701 SET16 READ/URITE BIT RAP 
1711 



115 
-I 
116 
117 



1117 
-I 
1120 
1121 



I 177| 

I- 






1127 



The Set RttJ/Urite Table starts on a ussr label boundary after the Iten 
Read/Urite Table. There trt eight uorde for each Set Read/Urite bit nap. 
For databases uith nore than <6 data sets, the read/writs table continues in 
the next user labels. The specific fomat of this table is shown on the next 
page. 

The nunber of user labels occupied by the Set Read/Urite Table depends on the 
nunber of data sets defined in the schena, and is obtained by rounding up- 
uanJs (ceiling) the result of: 

Nun-of-Jabels * [(Nun-of-sets)*8]/128 

Sir.ce thert can only be a naxinun of 199 data sets defined in the schena the 
naxmjn size for this table in user labels is: 

rtax-nze * [(195',«8)/128 « 12.44 > 13 labels 
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Rootfile Layout 

Root File - N »«t Ubtlfi) (Cont.) 

|teti/S«t Read/Unte Table Fomat 

There are eight words per iten/set Read/Urite Table definition and up to 16 
itens/sets per record (user label). Uithin each 8 words, the firtt 4 words 
»rt the flags for the user classes which have read access to the iten/set. 
The second 4 uords *rt the flags for the user classes which have unte access 
to the iten/set. The detail fomat for an eight word field is shoun belou. 

1 . Four words for read access: 



| 

I UORO 1 



I- 



15 16 

— I 

| UORO 2 

— I 



31 32 

— I 

I UORO 3 

— I 



47 48 

— -I- 



j UORO 4 I 
-I 1 



Four uords represent 64 bits. Bit n represents read access for user class 
n to the iten/set. If bit n is set to 1 then user class n has read access 
to the iten/set. For exanple, if the word settings are: 

UORD 1 UORO 2 UORO 3 UORO 4 
Z000016 Z02OO00 Z000410 1001300 

This neans that user classes 12, 13, 14, 18, 39, 44, 54, 56 and 57 haye 
read access to the iten/set. If no read/write security is defined at all 
for the iten/set, then all of the read security bits art set to 1. 



Rootfile Layout 



Root File Record 



| 

0| ROOT'OBSTRTUS 

1| ROOT'DBNAIIE 

21 

31 

4| 



51 ROOT'TRLRLGTH (TRAILER AREA LENGTH) 

6|R00rBUFFLGTH (BUFFER LENGTH) 
I- 



2. Four words for write access: 
15 16 



I- 



-I- 
| UORD 2 



31 32 



-I- 



| UORD 3 
-I 



47 48 

1- 



| UORD 4 
-I 



Urite access flags have the sane fomat as the read access flags. Bit n 
represents urite access for user class n to the iten/set. If bit n is set 
to 1, then user class n has write access to the iten/set. For exanple, if 
the word settings are: 

UORD 1 UORO 2 UORD 3 UORD 4 
Z000010 Z020000 ZOOOOOO Z001100 

This neans that the user classes 12, 18, 54 and 57 have urite access to 
the iten/set. If no read/write security is defined at all for the 
iten/set, then all of the write security bits are set to 0. 
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Rootfile Layout 



Root File Record (Cont. ) 



7| ROOT' LOTH 
101 

| 

111 ROOT'ITEhTT 
| 

121 ROOT'SETCT 

I 



(ROOTFILE LENGTH) 



(NUHBER OF IT Ens) 



M 

12 

13 

|4 
-I 

IS 
-I 

16 
-I 

|7 

IS 
-I 

19 
-I 

HO 
-I 

111 
-I 

112 
-I 

113 
-I 
161 ROOT'DEVICEPTR (RECORD » OF DEVICE CLASS TRBLE)|14 

17| ROOT'OBGFLAG MS 

| 1 

201 RESERVED (SET TO BLANKS) |16 



(NUnBER OF DRTR SETS) 



131 ROOT'ITEHPTR (RECORD • OF ITEH TRBLE) 
I- 



(RECORD t OF SET TRBLE) 



14| ROOT'DSETPTR 

15|~R00ri)SCBPTR (RECORD * OF DSCB'S) 
I- 



21 
22 
23 1 

24 

25 
26 

27 
30I 

31 
32 
33 
34 



NOUOPEN 



nnxoPEN 



PR' RESTART' CALENDAR 



RR' RESTART 'TMESTAHP 



RR' RESTART' FNAHE 



117 
118 
119 

-I 
I20 

-I 
121 

-I 
I22 

-I 
I23 
1 24 

-I 
I25 
1 26 
I27 
[28 

-I 
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Rootfile Layout 



35 | RE* RESTART 'FGROUP 

36| 

37! 

40 1 

41| RR' REST ART' FACCT 

421 

431 

44| 



I 

451 RESERVED 



(SET TO BINRRY O'S) 



29 
30 
31 
32 

33 
34 

35 
36 

37 



177L 



J127 



R00T»D8STATUS 

(0:8) - MAGE version ('C in ASCII) 
(8:8) - Binary 2 (filler) 

ROOT'DBNAIIE - DATABASE nane left justified (last 2 chart 9ft blank). 

NOUOPEN - Nunber of data sets opened. This field is not used in WAGE B & C. 

HAXOPEN - Haxinun nunber of data sets that can be opened. This field it 
not used in WAGE B & C. 

ROOT'DBGFLAG - 1: Infomation can fit in DBG. 

0: Infomation can not fit in DBG. 

AR* RESTART' FNRHE - Restart file ran« for DBRECOV stop/ restart. 



Root File Record 1 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I — I — I — I — I — I — I — I — I — I — I — ■ — ■ — ■ — ■ — « — ■ 

0| J 

II i 1 

• ITER RAP 



36I 
37| 



40 | RESERVED FOR FUTURE USE 
41 1 



761 

771 

I- 
1001 
1011 



130 
131 
-I 

1 32 

1 33 



I62 
I63 
-I 
I64 
I65 



SET HAP 

1361 
137| 

1401 RESERVED FOR FUTURE USE 
1411 



1761 
1771 
I- 



194 
195 
-I 
196 
197 



1126 
1127 



The Ittn Rap occupies Uords 0-31 . 

The Set Hap occupies Uords 64-95. 

These two naps are used by D80PEN for faster access to infomation in the 
Iten Table and Set Table. 
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Rootfilt Layout 



Root File Record 2 



I 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 

l~l--l--!- : l--l--l--l--l--l--l--l--l--l--l 



0| ITER KRnE 1 

11 

21 

31 

4| 

51 

61 

71 
| 

101 ITEfl NO. OF SYNONYfl 



l-l 
10 
11 
12 
13 
14 
15 
16 
17 



I- 



111 RESERVEO 1 
121 ITEfl TYPE 



| 

I RESERVED 2 
-I- 



131 SUBITEfl LENGTH 
I- 



| SUBITEfl COUNT 
-|- 



14| ITEfl NRRE 2 

151 

161 

171 

201 

211 

221 

231 

I 

24| ITER NO. OF SYNONYfl 



I NOT USED 
-I 



I- 



251 RESERVED 1 
| 

261 ITEfl TYPE 
I 

271 
301 



-I 

I RESERVED 2 



-I- 
I SUBITEfl COUNT 



SUBITEfl LENGTH 



-I- 
| NOT USED 



19 

-I 
HO 

-I 
111 

-I 
112 
113 
114 
115 
116 
117 
118 
119 

-I 
1 20 

-I 
121 

-I 
1 22 

-I 
I23 
I24 



Tht Ittn Tablt ttarta in record R2. 

Each entry it 12 uordt Ions and tht ltngth of tht tablt depends on tht 
nunbtr of data ittnt dtfintd in tht tchtna. Tht rtiativt potition of 
•n ittn dtfinitien dtptndt on itt relative potition in tht tchtna. 

Ittn-nant: it a data ittn nant, ltft-justified and uith trailing blanks 

Ittn-nunber-of-tynonyn: it tht nunbtr of tht ittn uhott nant hat tht 
tant hathtd result at thit ont (thit it 
utilized for quick ittn nant ttarchtt). 

Ittn-typt: it ont of tht following: I, J, K, R, X, U, Z, or P 



G.23.00 
21- 14 



Rootfilt Layout 



Root Filt - Nt*t Reeordts) (Cont.) 



Stt Tablt follout the Iten Table. Each entry it 12 uordt long. Tht ltngth 
of the tablt depends on tht nunber of data sets defined in tht sehtna. The 
relative position of a stt dtfinition dtptnds on its rtiativt position in tht 
tchtna. 

Set-nant: it a data stt nant, left-justified and uith trailing blanks. 

Stt-nunbtr-of-tynonyn: it tht nunbtr of a data stt uhott nant has the sant 
hashtd result as this ont (this it utilized for quick ttt nant sea-:*»es). 

Data-set-typt is ont of tht follouing: R, fl, or D. 

DSCB-pointtr: it a pointtr to tht Data Stt Control Block. Thit pointtr it 
uord offttt fron record NO. Tht DSC6 is described belou. 

The naxinun tizt for thit tablt is * 2*1 99 * 2388 uordt. 

NOTE: Tht restrvtd-1 and rtstrved-2 fitldo are tht 'old' ltvtl nunbtre for 
tht read and uritt access rtsptctivtly. Sinct thit conctpt no longtr ap- 
pliet, tht valutt are stt to zero. 
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Rootfilt Layout 



Root File Record 2 (Cont.) 

ITEM-TYPE 
I 
VALUES, 20J2; 

| | SUBITEfl- LENGTH 
ISUBITEfl-COUNT 

The naxinun tizt for thit tablt it 12*1023 ■ 12276 uords 

NOTE: Tht restrvtd-1 and rtstrved-2 fitlds are tht 'old* ltvtl nunbtrt 
for read and uritt ttcunty. Nou, tht valuta are aluays ztro. 



^ 



Root File- Next Record(t) Set Table 



12 3 4 5 6 7 8 

0| SET-NRflE-1 

11 

21 

31 

41 

51 

61 

'! , 



9 10 11 12 13 14 15 



10| SET-NO-OF-SYNONYfl 



I- 

111 RESERVED-2 
| 

121 DSCB-POINTER 
131 



I RESERVED-1 
-I- 



| DRTfl-SET-TYPE 
-I 



I 

10 

11 

12 

13 

|4 

15 

16 

17 

-I 
18 

-I 
19 

-I 
HO 
HI 

-I 
112 
113 
114 
115 
116 
117 
118 
119 

-I 
120 

-I 
2S| RESERVED-2 I DRTR-SET-TYPE 1 21 

261 DSCB-POINTER 122 

271 123 

| 1 

30| 124 
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I 

14| SET-NRBE-2 

151 

161 

171 

201 

211 

221 

231 

24| SET-NO-OF-SYNONYfl 



I- 



I RESERVED-1 
-I- 



Rootfilt Layout 



Root File - Next Rtcordts) (Cont.) 

Data Stt Control Blocks (DSCB)- General Layout 



DRTR SET GLOBRl RRER (SET 1) 

(CRPRCITY. LENGTHS, COUNTS, ETC.) 



30 UDS. 



RECORD DEFINITION TRBLE (SET 1) 
R. ITER NUflBERS 
B. ITEfl DISPLRCERENT 



FIELDC0WT*2*1 



PRTH TRBLE (SET 1) 

(SERRCH ITER. SORT ITEfl, ETC.) 



PRTHC0UNT*3 



DRTR SET GLOBRL RRER (SET 2) 

(CRPRCITY, LENGTHS, COUNTS, ETC) 



30 UDS. 



RECORD DEFINITION TABLE (SET 2) 
R. ITEfl NUflBERS 
B. ITER DISPLACEMENT 



FIELDC0UNT*2*1 



PRTH TRBLE (SET 2) 

(SERRCH ITER. SORT ITER, ETC.) 



PRTHC0UHT*3 



\ 
I 

I 

I 

I 

I 

I DSCB 

I SET1 

I 

I 

I 

I 

I 

/ 

\ 

I 

I 

I 

I 

I DSCB 

I SET2 

I 

i 

f 

I 

I 

/ 



DRTR SET GLOBRL RRER (LRST SET) 
| (CRPRCITY. LENGTHS, COUNTS, ETC) 
I 
I— 

RECORD DEFINITION TRBLE (LRST SET) 
| R. ITER NURBERS 
I B. ITER DISPLRCERENT 



— I 



I \ 



30 UDS. I 
— I 



I— 



PRTH TRBLE (LAST SET) 

(SERRCH ITER, SORT ITEfl, ETC.) 



FIELDC0UNT»2*1 I 
— I 



PRTHC0UNT*3 I 



DSCB 
LAST SET 



J*RBK 



Tht DSCBt follow tht SET TRBLE in tht Root Filt. Thtre it ont DSCB for taeh 
data ttt dtf intd. Tht function of tht DSCB it to dtf int tach data ttt uithin 
tht data batt. 
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Rootfilt Layout 



Root File - Ne«t ggardjij (Cont.) 
Data Set Control Block 1 Global Area) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I — | — | — I — I — I — I — I — I — I — I — I — I — I — I — I — I 

0! DSCftP (OATA SET CRPRCITY) |0 

'i r 

2 1 DSBLOCKLGTH (BLOCK LENGTH) 1 2 

| 1 

3 1 DSItEDIALGTH (REDIA RECORD LENGTH) 1 3 
| 1 

4 | OSENTRYLGTH (ENTRY LENGTH) |4 

j 1 1 

SI OSBLOCKFRC I OSPRTKCT 1 5 

6 1 OSFIELDCT 1 6 

7 1 N| DSPRMKEY 1 7 

| .. | 1 

101 OSPRTHPTR (OFFSET TO PATH TABLE) 18 



I 

111 LOGICAL ENO OF FILE 
121 

13| RAX NUH OF RECOROS IN SET 
14| 






I 



| 

15| 17 UORDS OF BINARY ZEROS 



35| 



19 
HO 



111 
112 



I- 



113 



1 29 

-I 



OSCAP - Data ttt capacity at reported by the SCHEMA processor. 

DSBLOCKLGTH - Oata act block length including the bit nap overhead. 

DSHEDIRLGTH - Data set nedia record length (renenber that thie length 
includes the pointer overhead) 

OSENTRYLGTH • Oata set entry length. 

DSBLOCKFRC - Data set blocking factor. 

DSPATHCT - Data set path count. This is the mmber of paths that are 
spscified for the data set. 
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Rootfile Layout 

Root File - Next Record(e) (Cont.) 

Data Set Control Bloek (Record Definition Iten Disolaccnent) 



I 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I — i — i — i — I — I — i — I — I — I — i — I — I — I — i — I — | 

0| OFFSET TO 1ST FIELD 



1 | UORD OFFSET TO 2ND FIELD 



2IU0RD OFFSET TO 3R0 FIELD 



| UORD OFFSET TO LAST FIELD 
| LENGTH OF ENTRY 



I 



This table immediately follows the Iten Nvnbers Table. 

The uord offset points to the starting location of the field uithin the nedia 
record. Renenber that the nedia record includes the pointer overhead so this 
offset varies for naster and detail data sets. If a naster data set hat only 
one path, the uord offset for the first field ie 11, since there are 11 uords 
of overhead (6 uords for the eynonyn chain pointers and 5 uords for the data 
apt chain head that it uould be pointing to). On a detail data set uith one 
path, the overhead is only 4 uords. 

The ' LENGTH-OF-ENTRY* field is the sane as the nedia record length. 
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Rootfile Layout 



Root File - Next Record( s) (Cont.) 

OSFIELDCT - Data set field count. This is the number of fields 
specified for the data set. 

X-DSKEYTYPE - Data set key type. If DSKEYTYPE * TRUE then 
the key is hashed. 

DSPRMKEY - Data set primary path or key. 

For naster data sets, this is the field nunber of the 
search iten. 

For detail data sets, this is the field nunber of the 
prinary path. 

DSPATHPTR - Oata set path table pointer. Uord offset to the data set 
path table uhich contains an entry for each path defined. 
It points to path Oth entry in the table, so to get to 
the first entry the pointer should be mcrenented by the 
length of the entry (uhich is currently 2 uords). 



Data Set Control Block (Iten Nunbers) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

|-.|H~|H-|-|-M--|"I~I"I-I~I-I~I 
0| ITEM NUH OF 1ST FIELD I 

I 1 

1 1 ITEfl NUH OF 2ND FIELD I 

| j 

21 ITEfl NUH OF 3RD FIELD I 

, j 

.1 ETC. I 

, 1 



The Iten Nunbers Table follous the Global Area of the DSCB. The eize of this 
table (in uords) is equal to the nunber of itens in the given data set. 
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Rootfile Layout 



Root File - Next Record(s) (Cont. ) 
Data Set Control Block (Path Table) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I — I — I — I — l — I — I — I — I — I — I — I — I — I — I — I — I 

) 0| 1ST PATH DEFINITION I 

n ! 

•l. 

31 2ND PRTH DEFINITION 

41 

51 

| 

61 



1 

I 
I 



LAST PATH DEFINITION 



I- 



There are 3 uorde (6 bytes) for each path definition. The Path Table 
for naster data sete hae a different layout f ron the Path Table for detail 
data sets. 

(taster sets: 

B>te Description 

1-2: iter nunber of the search iten in the related 

detail set. 

iten n^rbtr of tne sort iten in the related 

detail set. 

set nunber of the related detail data set 

path nunber of the corresponding path in 

the related detail data set. 



3-4: 



Detail sets: 

Byte Description 

1-2: field nunber of the search iten. 

3-4; f;»jd no. ber of the sort iten. 
5: set nur.ber of the related naster data set 
6: path •wnber of the corresponding path in 
the related naster data set. 
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Hoot flit Layout 

Root File - W »»t R.eord(s) (Cont.l 

Dtvice Class Table 



I 



I 
01 
11 
21 
31 
I 
41 
51 
61 
71 

I- 
101 
111 
121 
131 

I- 
14| 
151 
161 
171 

I- 
201 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
— I — I — I — I — I — I — I — I — I — I — I — I — ■ — ■ — ■ — ■ 

DEV CLASS MW1E 1 \ 



DEV CLASS NAHE 2 



DEV CLASS NRHE 3 



DEV CLASS NRHE 4 



M 
12 
|3 

-I 
|4 
15 
16 
|7 

-I 
18 
19 
MO 
HI 

-I 
112 
113 
114 
115 



— I 



H6 



Dcvict Class Table folloui tht DSCBt. 

Each tntry it 4 words long, and contains tht dtviet elatt nant which it op- 
tionally tptcifitd for a data ttt by tht uttr. For data tttt without uttr 
tptcifitd dmce clatt nantt, tht tntntt will bt filltd with blanka. 

Tht ltngth of tht tablt dtptndt on tht nunbtr of data tttt dtfwtd in tht 
tchtna. Tht relative potition of a dtviet clatt tntry dtptndt on itt rela- 
tive position in tht tchtna. 

Tht naxinun tizt for thit tablt it 4*199 • 796 uordt. 



Rootfilt Layout 



User Label 



General Data Set Layout 



WORD 0-11 nRSTERS=CflPRCITY | 
I DETRILS'HIGHUfiTER flflRK I 
, 1 

UORD 2-31 NUHBER OF UNUSED RECORDS I 
| 1 

UORD 4-51 HRSTERS* NOT USED I 
I DETAILS' DELETE CHAIN HEAD | 
| 1 



RECORD 01 
I 



RECORD N| 



| -RECORD THROUGH N— 



DATA RECORDS 
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Rootfilt Layout 



Data Stt Uttr Label 

word 0-1: Record nant of tht highttt readable record. Record nant contittt 
of an RPE filt record nunbtr (0 bytt to 2nd bytt) and a tlot nun- 
be r (3rd byte), uherc the ItPE filt record nunbtr it equal to tht 
quotient of tht highttt tntry divided by blocking factor and tht 
tlot nunbtr it tqual to tht renainder of tht highttt tntry dividtd 
by blocking factor. For Hesters, thit it tht highttt record in 
tht ttt (i.e., Capacity). For Detailt thit it tht grtatttt nunber 
of rtcordt that have been written to the ttt thus far. For ex- 
anple, if there it roen in the Detail data ttt for 100 rtcordt and 
75 utrt written last uttk uhan tht data ttt uat loadtd with 
DBLOAD, and yesterday IS rtcordt utrt dtltttd fron tht data ttt, 
tht High Uater nark should point at the highest entry, '75', in 
the for* of record nane. If the data ttt hat a blocking factor of 
10, tht record nant should have an ItPE record nunbtr of 7 and a 
tlot nunber of 5. 

Word 2-3: Nunber of unuttd rtcordt in tht data ttt. Thit fitld it incrt- 
nented uhen a record it dtltttd and dtcrtntnttd when a record it 
added. To detemme the current nunber of entriet uttd in tht ttt 
tubtract Uord 2-3 (unuted count) fron word 0-1 (Capacity). 

Uord 4-5: Tht dtlttt chain htad for Dttailt. Thit points to tht record nott 
recently deleted or contains a valut of zero if no rtcordt have 
been deleted. Thit fitld it not uttd in hatter data tttt. 



Data Set Records 

The data in the data »et records is arranged according to tht Htdi* rtcordt. 
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Disc Free Space flap 

CHAPTER 22 DISC FREE SPACE HAP 

Disc Resident Data Structures 

There are two ditc rttidtnt fret spact data structurts, tht bit nap and tht 
dtscriptor tablt, for tach ditc volune that has a free space nop, i.e., sys- 
ten discs and private volunes. The addresses of these data structures are 
kept in the diec label. The synbols that define the descriptor table and bit 
nap art in tht indudt filt INCLDFS2. 



Bit llao 



Tht bit nap it dividtd up into pagts, which is tht phytieal block of the nap 
that it read or written. At the nonent, a page is defined to be one sector 
long (128 uordt). Thit nay bt changed by changing a conpile tine constant. 
The latt word of tht pagt it a chtcksun for that page, all othtr words art 
data. Thtrt it a ont to ont correspondence between bitt in tht nap and stc- 
tort of tht ditc. A ont bit represents a free sector and a zero bit 
represents an allocated eector. The bit nap is a contiguous stt of paget, 
tnough to represent the entire disc, excluding spare tracks and spars 
sectors. 

Descriptor Tablt (DT) 

Tht dttcriptor tablt it »n »rr»y of three word entriet, one entry for each 
page of the bit nap. Each entry looks «* follows: 



I ! 

UOftO 0| LARGEST SPACE I 



I 
Ml 
I 
I— 

I 



I 

STARTING SPACE I 

I 

-I 

I 



UORD 21 ENDING SPACE I 



/^^Ik 
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Disc Frti Space nip 



Tht descriptor table looks ss folloua: 



I 1 



| ENTRY FOR PAGE 
-I 



1 



| ENTRY FOR PAGE 1 






| ENTRY FOR PAGE 2 






| ENTRY FOR PAGE 3 






I — 



| ENTRY FOR LAST PAGE 
-I 



Each entry describes the free space on the corresponding page of the bit nap. 
The largest space word is the size of the largest contiguous block of free 
space on the page, which is not at the very beginning or very end of the 
page. That is, the first bit physically representing the space is not the 
first bit of data on the page or the last bit representing the space is not 
the last bit of data on the page. Starting space is the nunber sectors of 
contiguous space represented by the set of bits uhose first bit is the first 
bit of data on the page. Ending space is the nunber of sectors of contiguous 
space represented by the set of bits uhose last bit is the last bit of data 
on the page. The starting space and ending space fields allow looking across 
page boundaries, thus preventing fragnentation on page boundaries. 
Therefore, if all sectors represented on a page *rt free, then starting and 
ending space uill be the sane and have the total nunber of free sectors 
represented on the page. Largest space uill be zero, as there is no block of 
space that is not at the beginning or end of the page. A value of - 1 for 
all the fields in an entry indicates the corresponding page is bad, cither 
f ron a checksun or I/O error. 



Virtual nenorv Resident Data Structures 



For each systen disc or physically nounted private volune there is a data 
segnent uhich has information about the disc free space nap, the current copy 
of the descriptor table, sons uork space for the procedures uhile in split 
stack node, and buffers for pages of the bitnap. The DST nunber of the data 
segnent for a given disc is found in the LDTX entry for that diac. 



Disc Free Space nap 



Pi« c Free Space Data Segnent, 
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For each systen disc or physically nounted private volune m the up and run- 
ning systen there is a DST uhich contains information about the disc free 
space nap for that disc, sons uork area, a copy of the descriptor table and 
buffers for the pages of the bit nap. 

All synbols that define these data segnents are in the include file INCLDFS1, 
and they *n prefixed uith "OS'". The structure of the data segnent is as 
follous: 



| 1 

Ol DS'LDEV 10 

j 1 

1| DS'DST 11 

| 1 

21 12 

I- DS'DISC'SIZE -I 

31 13 

| 1 

4 | OS* LAST" PAGE' OF' HAP |4 

, 1 

5| OS' LAST' BUFFER' INDEX 1 5 

| 1 

61 16 

|- DS'nAP' ADDRESS -I 

'! !/ 

101 DS'LOCK 18 

, 1 

111 OS' LOCK* COUNT 19 

| 1 

121 DS' QUEUE 'HEAD MO 

131 DS'QUEUE'TAIL |11 

| 1 

14| OS* DESCRIPTOR' TABLE |12 

, 1 

151 OS' BUFFER' PAGE 'NUHBER |13 

161 DS' BUFFER' DIRTY I 14 

17 | DS' BUFFER' AREA |15 

20| DS'FIRST'THRESHOLD'PAGE f 16 

, 1 

21! 117 

I- DS'SIZE'OF' LAST' ALLOCATION -I 

22I 118 

, 1 
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Data Seenent Structure (Cont.) 










1 23 


DS' LAST' PAGE' ALLOCATED' FROfl 


19 


1 24 


DS' NEXT' BUFFER' INDEX 


20 


1 25 


DS'PAGE'NWBER 


21 


1 26 


DS'UORD'NUnKA 


22 


1 27 


DS'BIT'NUnBER 


23 


1 30 


OS' PAGE' POINTER 


24 


1 31 


DS' STARTING' UORD' NUHBER 


25 


I 32 


OS' STARTING' BIT 'NUHBER 


26 


I 33 
I 34 


- DS'NUnBER' OF' SECTORS 


27 
28 


I 35 


OS' BIT' COUNT 


29 


I 36 


DS' ENTRY* TYPE 


30 


I 37 


DS' BUFFER' INDEX 


31 


I 40 
I 41 


- DS' DISC ADDRESS 


32 

33 


I 42 


DS' ERROR' STATUS 


34 



Disc Free Space Hap 



DUflflY 

| ENTRY 



LARGEST SPACE 



STARTING SPACE 
ENDING SPACE 



LARGEST SPACE 
STARTING SPACE 
ENDING SPACE 



ENTRY FOR 
PRGEO 



ENTRY FOR 
PAGE 1 



The rest of the data segnent contains tables uhose size and location is 
dependent on the size of the disc and/or the nunber of buffers in the data 
segnent. They are shoun belou just to denonstrate their relation to one 
another, for their actual location, the pointers should be exanined. The 
synbol "DS'ARRAY'RREA" defines the start of the »r%». The first table is the 
descriptor table, it is in the sane foroat as the disc copy, but a rfunny 
entry of all zeros is added before and after the table, these are needed by 
procedures "FIND'PAGE" and "BUILD•DESCRIPTOR , ENTRY ,, . The pointer to this 
table is "OS* DESCRIPTOR' TABLE", it points to the entry for page zero, not the 
dunny entry. 
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The next table is DS' BUFFER 'PAGE 'nunber table, it has a one uord entry for 
each buffer in the data segnent. Each entry contains the page nunber of the 
page currently in the corresponding buffer or -1 if the buffer is enpty. 
This is poinded to by "DS' BUFFER' PAGE 'NUnBER". 



| 

I BUFFER ENTRY 

I BUFFER 1 ENTRY 
I- 



1 

J 



I 

I LAST BUFFER ENTRY 
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Tht next table it tht DS' BUFFER* DIRTY tablt, uhich has a ent word in try For 
eaeh buffer. R TRUE indicates tht page in tht corresponding buffer is dirty, 
i.e., tht disc copy it not up-to-date. R FALSE indicatts that tht bufftr it 
cltan. If OFS uas compiled with dirty bufftr nanastntnt tumid off, thit 
table it not present and the OS* BUFFER' DIRTY pointer it zero. 



| BUFFER ENTRY 

| BUFFER 1 ENTRY 
I 



| LAST BUFFER ENTRY 



1 

I 
1 

I 
1 



I- 



The renaindtr of tht data segnent contains the buffers. Each buffer is the 
size of ont page of tht bit nap, uhich it currently ont stctor(128 uords). 
The beginning of the buffer trt* it pointtd to by "DS* BUFFER' RRER" and the 
nunber of buffers is the value in "DS'LAST* BUFFER' INDEX" plus one. 



I 

I 

I BUFFER 

I 

I 



I 



-I 



I BUFFER 1 
I 

I 



I 

I 

I 

I LAST BUFFER 

I 

I 
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CHAPTER 23 HPE DISC CRCHINO 



Disc Caching Overview 



Disc Caching it an optional Feature oF APE that utilizes excess nain 
memory/CPU horeepouer to keep portions oF Frequently referenced disc 
"domains" in nenory. (R disc "donain M is a copy of a portion oF disc rteid- 
ing in nain nenory. These disc donains ere considered "cached" uhen they are 
in nenory and are considered "napped" uhen there is I/O pending against 
then.) Disc Caching nanages the bi-directional traneFer of these disc 
donains between nain memory and disc storage. No nain nenory ie pernanently 
dedicated to caehed disc donains. Cached disc donains share nain nenory uith 
all other types of RPE segnente and are not treated differently by the nenory 
nanager. By keeping cached disc donains in nenory, a significant portion oF 
the references to disc storage can be resolved uithout actually needing to 
physically access the disc. Disc Caching policies art integrated into the 
RPE Kernel, File Systen, and I/O Systen uhich alloue tht syeten performance 
to be tuned based on the current uorkload and resource availability. 

Disc Caching usee the RPE kernel resource nanagenent nechanisae and 
strategiee. These nechanisne art extended to handle cached disc donains in 
the sane manner as segnente. Thus, cached disc donains can be of variable 
size, fetched in parallel uith other eegnents or cached donains, garbage col- 
lected, and replaced in the sane nanner ae stacks, data and code segnente. 
The relative use of nain nenory between etacke, data and code segnente, and 
cached diec donains is dynanic. This partitioning is based on the current 
workload requirements and current nenory availability. 

Disc Caching can be enabled/disabled en a diec-by-disc basis. Hhen caching 
is enabled for the first disc, the code segnent containing the Disc Caching 
code will bt locked into nenory. Rlso at this tine the Cache Directory Table 
(COT) will be built and locked into nenory. Uhen caching ie ditrtltd f ?f *• 
last disc, the code segnent will be unlocked frcn memory and the COT will be 
released. Thue if caching is not enabled no ntnory uill be wasted. 

The CDT ie used to keep track of the following information: 

1. The disc Ldevs currently enabled For caching. There uill be a Device Entry 
in the table for each cached disc. 

2. fl linked list of cached donains For each disc uith caching enabled. The 
head and tail of this linked liet will be contained in the Device Entry 
(i.e., there is a separate linked liet of cached donains for each cached 
disc Ldev). 

3. The cached donains that currently have user I/O pending (i.e., 
FRERDs/FURITEs) or have nenory nanagenent I/O pending (i.e., fetching the 
disc donain into nenory, or posting the disc donain back out to disc). 
There will be a Rapped Donain Entry in the table for each disc donain has 
that I/O pending and is thue "napped". 
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Each oF the fields of the data segnent is described in the include file 
INCLDFS1, where they are defined. It should be noted that the following 
fields *rt just workspace, used to pass information between procedures while 
in split stack node and have no ntaning bttuten calls to the disc fret space 
nanagenent tubsysttn: 



DS'PRGE'NURBER 

DS'BIT'NUHBER 

OS' STARTING' UORO'NURBER 

DS'NUHBER' OF 'SECTORS 

DS* BIT' COUNT 

DS' DISC* ADDRESS 



OS'UORO'NURBER 

OS'PAGE'PTR 

DS' STARTING' BIT 'NURBER 

DS' ENTRY 'TYPE 

DS' BUFFER' INDEX 



The field DS* ERROR' STATUS nomally has no neaning between calls unless the 
ERROR* TYPE field has a value greater than "FATAL' OFS* ERROR", which means that 
disc space n»y no longer be allocated on this disc. 
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4. R linked liet of all ueer I/O pending against the napped disc donains. 
There will be a Logical Disc Request (LDR) queued to the Rapped Donain 
entries that will describe the user I/O to take place. This is analogous 
to a Disc Requeet queued to a specific DIT waiting For service. 

Uhen a request is nade to access disc information, Disc Caching nust first 
determine if the requested disc donain is present in memory. Disc Caching 
uill first detemine if the requested *rf of diec is already napped into 
nemory by scanning through the Rapped Donain ent rin oF the COT. If the 
requested tranefer can be satisfied uith a currently mapped disc domain, then 
the I/O request uill be queued (FIFO) behind the other I/Os pending against 
that napped donain. If the requested area ie, not already napped, then a 
search is ntit through the linked list of eached disc donains For the 
specified disc Ldev. (The region header containe the dise address and size 
that a disc donain represents.) If the requested donain ie found in this 
list (i.e., present in nenory), then this region uill be napped. R donain is 
then considered napped when there is an entry for it in the Rapped Domain 
portion of the CDT. Happing the donain allows Disc Caching to nanage either 
a pending or currently active I/O for a particular diec donain. Once tht 
disc donain is napped and present, the data can be noved between the process' 
data area and the napped disc donain. The process can then continue execut- 
ing uithout interruption or a process switch. The ueer/subsysten process For 
uhich the novo is done will be charged with the CPU overhead. 

Uhen a requeet is nade to read data that is not currently cached in memory 
(i.e., a read "mies"), the fetch strategy usee the File Syetem's knouledge 
of the type of access (sequential or rand on), the extent eize of the file, 
along uith the current nenory load to eelect the optinal size of the dise 
donain to be fetched and napped into nemory. The fetch of the disc donain is 
then initiated on the user's stack without a process switch. After the fetch 
is initiated, it conpletes in an unblocked nanner eo that thie proeess (if 
no-wait I/O) or another process can proceed in parallel with the cache fetch. 

In general, when uriting, a proceee will not wait for completion of tht 
physical I/O. Instead, the process will be awakened ae soon ae the transfer 
has conpleted between the process's data »rt» and the napped diec donain 
(i.e., no-uait-for-poat). The physical I/O will then be potted it background 
priority while the process continues. (Users can specify uait-for-poat on a 
file by file basis in place of the default no-ueit-for-poet uith the FSETRODE 
intrinsic, or on a global basis via :CRCHEC0NTR0L.) If the acceee request ie 
a write and there is a current write pending against the specified napped 
diec donain, the process request is qteued until the pending urite ie potted 
to disc. If the disc donain to be untten ie not currently cached in nemory, 
a free piece of nenory will be obtained to nap the corresponding diec inage 
and then the "urite" taJ-ie place from the process' data area to the napped 
disc donain. This prevent data from naving to be read before being written. 
After that, a post to disc i* initiated („n any write only the portion of a 
napped disc donain that is modified .ill be posted to disc). After the novo 
to the nappe* disc donain is conplete a-.d -he post to disc is initiatsd, the 
process performing tht "write" is allowed to continue to run uithout having 
to wait for the post to conplete. Urite* that nust be posted to disc in a 
certain order use the Global Serial Urite Queue. These ordered uritee in- 
clude thing? like updati*3 disc free space naps for a neu file extent before 
updating the file extent nap in the file label. 
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There are tuo disc request entries used for disc caching requests. The firtt 
entry it a Logical Disc Request (LOR) entry and it uted to Manage the data 
novei to/fron the uter't data area and the ditc dentin (i.e.. the logical 
I/O). The tecond entry is a regular Ditc Requett (ORQ) entry and it uted to 
perforn the phytical I/O necettary to nap a disc donain (for a read nits 
or to perforn the physical post (on unte rtquests). The disc donain Mill 
rtnain napped until both the logical and physical I/O eonpletes. If a 
request is not conpletely described by one disc donain already in nenory or a 
napped Donain COT entry (i.e.. the requested disc •«•'•"• *"to nore than 
one disc donain) then the overlapping disc donain(s) Mill be flushed to disc 
and the new ccnplete disc donain uill be fetched (if read) and napped. Mo 
partial nappings are alloMtd. 

The OST nunber of the Cache Directory Table (CDT) is at X1273 and the bank 
and offset *rt kept in X1274-X1275. The Caching SIR (2) is used uhen start- 
ing and stopping caching (via :STRRTCACHE/:STOPCACHE) and by the LORDER uhen 
loading a progran file (this SIR is only used uhen updating the STT at load 
tine). 

Uhen caching is enabled for a disc, a bit in the flags uord of the OIT is 
tet. Also, the Global Serial Unte queue can be found by exanining the 
header entry of the Oisc Request Table. See Chapter 13, "I/O", for a nore 
detailed explanation of both the OIT and the Oisc Request Table header. See 
Chapter 2, "nenory Ranagenent Tables", for a description of the nenory Region 
Header for a disc donain (cached region). 
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Henorv Regions 
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Caeh« Directory Table 



The Cache Directory Table (COT) is the bookkeeping strvcturt for nanaging 
cached disc donaint. Thit table is divided into three parts: 

1. CDT Header Entry 

This entry contains all infomation necessary to nanage the entire table 
and also containa global caching related information. 

2. CDT Device Entry 

There uill be one of these entries for evtry disc Ldev that currently has 
caching enabled. These entries keep track of all cached disc donains in 
nenory for this device. In addition, these entries contain statistics 
regarding the nunber of I/Os perforned to the Ldev. 

3. CDT Happed Donain Entry . 
These entries deecribe disc donains that an currently "napped" into 
ntiwty. This neans that there is logical I/O (cache novo) and/or physical 
I/O (fetch or post) pending. These entries keep track of the state of the 
cached disc donain (MI, ROC, etc.) just as the DST Table keeps track of 
data segnents. 

The following lou core cells contain the addrets of the CDT: 

X1273 - contains the DST Nunber of the COT 
X1274 - contains the Bank Nunber of the CDT 
Z1275 - contains the Offset uithin the bank of the COT 
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Hf«der ?"trv 



01 I ENTRIES 



1| ENTRY SIZE (132) 
| 

21 N FREE ENTRIES 
I- 



31 1ST FREE ENTRY (TABLE OFFSET) 
I 



4 | LAST FREE ENTRY (TRBLE OFFSET) 
| 

5 1 nAX N ENTRIES USED 

6 1 tt LDEVS CACHED 

7| 1ST CACHE DEVICE ENTRY (ENTRY NUHBER) 



10! * UOROS THIS DST 
| 

111 TRUE IF STOPCACHE PENDING 

121 • SECTORS SEQUENTIAL FETCH 



I- 
131 N SECTORS RRNDOIt FETCH 



I- 



14| TRUE IF UAIT FOR PHYSICAL POST 
| 

151 HEAD OF WPEDED QUEUE (PIN) 

161 ™" " * 



I 
311 
I- 



COT' 

COT' 
COT' 
COT' 
COT' 
COT* 
COT' 
CDT' 
CDT» 
CDT' 
CDT' 
CDT' 
CDT' 
CDT' 



ENTRIES 
SIZE 

FREE* COUNT 
FREE 'HEAD 
FREE' TAIL 
HAX'USED 
NUTT LDEVS 
DISC 'HERD 
DST'UORDS 
STOP'PND 
SEQ'niNFTCH 
RND'HINFTCH 
FORCE'POST 
STOP' QUEUE 
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CDT' ENTRIES , ... 

The total nvnbtr of CDT entnet configured in this tabic (i.t., includes all 
three types of entries). The nunber of entries in the table will be: 
1 entry for the header 

♦ 1 entry for each disc Ldev configured. 

(CDT Device entries) 

♦ 1 entry for each ORQ configured. 

(CDT Happed Donain entries) 

This schene insures that this table can na^tr overflow (since an entry in the 
DRQ table is always obtained before an entry in this table). 

CDT' SIZE 

Size of each entry in the table. 

CDT' FREE' COUNT 

Total nunber of entries currently unassigned. 



-^ 



* entry size) of the first avail- 



CDT'FREE'HEAD 

Table relative offset (i.e., Entry 

able entry. 

CDT' FREE' TAIL 

Table relative offset of the last available entry. 

CDT' flAX' USED 

The naxinun nunber of entries in use at one tine. 

CDT'NUfl'LDEVS 

The nunber of ldevs currently cached. 

CDT' DISC HEAD 

The entry nunber of the first Device Entry. 

CDT'DST'UORDS 

The total nunber of uords in this data segnent. 

CDT' STOP'PND 

This value uill be TRUE if there is a pending :STOPCACHE. 

CDT 'SEQ'niNFTCH 

If there is a prefetch for a sequential read ("niss"), the size of the 
prefetch is delimted by the extent size of the file. Uithin this linita- 
tion, the prefetch is equal to the greater of two sizes: 

1. Requested size. 

2. The largest integer nultiple of the request size that is snaller than the 
value found in this cell. 



The default value is 96 sectors. 

:CACH£CONTROL.) 



(This value nay be changed via 
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CDT'RND'niNFTCH 

This is the sane as CDT 'SEQ'niNFTCH except that it's for randon access. The 

default value it 16 sector*. (This value nay be changed via :CACHECONTROL.) 

CDT' FORCE' POST 

Uhen this value it TRUE, all uritee uill "block" until the physical update on 

disc conpletes. The tysten default is FALSE. (This value nay be altered via 

:CACHEC0NTROL.) 

CDT* STOP' QUEUE 

If CDT 'STOP' PENDING is TRUE this uill be the PIN nunber of the Nad pin of 

the processes inptded until the :STOPCRCHE conpletes. 

COT' DE' NEXT' LDEV 

The entry nunber of the next Device Entry. 

CDT'DE'PREV'LDEV 

The entry nunber of the previous Device Entry. 

COT' DE* LDEV 

The Ldev nunber for this cached device. 

CDT'DE'nAPO'PAGES 

Total nunber of nain nenory pages allocated to disc donaine for this cached 
device. This includes napped and unnapped regions. (1 nain nenory page ■ 
128 uordt). 

COT'DE'nAPD'CNT 

The total nunber of napped Donain entries associated uith this Device Entry. 

CDT'DE'nUPD'HEAD 

The entry nunber of the first napped Donain entry for this device. 

CDT'DE'nAPD'TAIL 

The entry nunber of the last Napped Donain entry for this device. 

COT' DE' REGIONS 

The total nunber of diee donain regions for this Ldev (includes napped and 

unnapped regions). 

CDT'OE'REG'HD 

nenory address to the head region of the disc donain linked list. Disc 
donain regions art linked in order based on the disc addrtss they rro reset 
(i.e., snail disc address at head, large disc address at till). This address 
uill not point to the region base (RB), but to the next donain (NT) field cf 
the region header. (This is to facilitate the use of the LL>n instruction.) 
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CDT'DE'REG'TL 

nenory address of the tail region of the disc donain linked list. This ad- 
dress uill be of the previous donain (PD) field of the region header. 

COT'DE'RHIT 

Total nunber of tines that a read use requested and the requested disc donain 
uas present in nenory (i.e., a read "hit"). This neans that the read con- 
pleted uithout performing any I/O (to fetch the donain). Thus this is ac- 
tually the nunber of read I/Os elininated. This value uill reset to zero on 
overflow. 

COT'DE'UHIT 

Total nunber of tines that a urite uas requested and the requested disc 
donain uas present in nenory (i.e., a urite "hit"). If there uas no other 
urite pending to the "hit" donain, then the process uould continue as soon as 
the cache novo conpletes, therefore, elininating a block for I/O. Otherwise, 
the process uould block waiting for the first urite to conplete. Thie value 
will reset to zero on overflow. 

CDT'OE'RMSS 

Total nunber of tints that a reed uas requested and the requested disc donain 
uas not in nenory (i.e., a read "niss"). This neans that the requested disc 
donain had to be fetched into nenory before the read could conplete, there- 
fore, potentially blocking the process. This value uill reset to zero on 
overflow. 

CDT'DE'UMSS 

Total nunber of tines that a write uas requested and the requested disc 
donain uas not in nenory (i.e., a write "nits"). This does not nean that the 
process would block until the disc donain is fetched as is the case for 
reads. Rather, a free nenory region uould be obtained to be the destination 
of the cache nove. Thie disc donain would then be poeted in the background 
(unless overridden via : CACHECONTROL or FSETHODE) allowing the process to 
continue uithout blocking. Thit value uill reset to zero on overflow. 

CDT' DE' STOP 

Total nunber of tines that a process had to block on s cache transfer. Uill 

reset to zero en overflow. 

CDT'DE'SCANPT 

The nenory address of the laet region looked at on a search. This address 
uill be of the next donain (ND) field of the region header. Thie value will 
be used along uith CDT'OE'REG'HD to detemine where to start the next search 
for a cached diec donain. At tints it will be nore efficient to start with 
this address since the diec donain requested nay be of a higher diec addrtss 
than found in this region header, rather than aluaye starting the starch uith 
CDT'OE'REG'HD. 

CDT'DE'SHIFT"CNT 

The nunber of bits used to execute OLSL instruction. 

CDT'DE'nAKE'EVEN 

An additional uord used to nake the entry size an even nunber. 
CDT'ENTRY'SIZE nust be an even nunber for disc caching to correctly acceee 
the CDT Device Entry Table and the napped Donain Entry Table. 
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Device Entry 



01 NEXT LDEV ENTRY (ENTRY NUHBER) 

1 | PREV LDEV ENTRY (ENTRY NUHBER) 
| 

21 LDEV FOR THIS DISC 

31 » PRCES IN DEVICE'S DOHAIN 

4|~ i DISC DOnfllNS CURRENTLY RAPPED JCDT'DE'HAPD'CNT 
1 

5| HERD OF HAPPED DOHAIN (ENTRY NUHBER) | CDT 'DE'HflPD' HEAD 

6|""tWL0F flflPPEO DOHAIN (ENTRY NUHBER) COT* OE'HRPD' TAIL 
7|"i DISC DOflfllN REGIONS FOR THIS DEVICE ICDT'DE' REGIONS 



-I 

ICDT'DE' NEXT 'LDEV 
-I 

ICDT'DE'PREV'LDEV 
-I 

ICDT'DE' LDEV 
-I 

ICOT'OE'nflPO'PROES 
-I 



I- 
101 HEHORY RDDRESS OF HERD 

| CACHED DISC DOHRIN 

121 HEHORY ROORESS OF TAIL 
I- 
I CACHED DISC DOHRIN 



I- 
141 

I- I RERD HITS 
I 

161 
|- II URITE HITS 
I 

201 



I- N RERD HISSES 

I 



I- 
221 



I- # URITE niSSES 
I 



241 



I- « STOPS 

I 



I- 



ICDT'DE'REG'HD 



ICDT'DE'REO'TL 



CDT'DE'RHIT 



COT'DE'UHIT 



CDT'DE'RHISS 



CDT'DE'UMSS 



CDT'DE'STOP 



261 HEHORY RDDRESS OF LAST 
I- 
| REFERENCED DOHAIN 



I- 
301 II BITS TO SHIFT 



I- 

31 | NOT USED 
| 



ICDT'DE'SCANPT 
-I 

I 
-I 

ICDT'DE'SHIFT'CNT 
-I 

ICDT'DE'HAKE'EVEN 



-I 
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CDT'HD'PREV 

Entry nunbtr of the previous nappsd donain tntry for this dsvict. 

CDT'HO'NEXT 

Entry nunbtr of the ntxt napped donsin tntry for this dtvict. 

COT' HD' SECTOR 

Tht starting disc stctor addrtss rtprtttnting this napptd donain tntry. 

CDT'HD'END'SECTOR 

Tht tnding disc stctor addrtss rtprtttnting this napptd donain tntry. 

CDT'HD* FLAGS 

Flags describing tht state of this napptd donain tntry and tht region as- 
sociated uith it: 



(0:1) - 

(1:1) - 

(2:1) - 

(3:1) - 

(4:1) - 

(5:1) - 

(6:1) - 

(7:1) - 



(Set uhen the fetch for this 



Absent. 

Region is not present in nenory. 

Ifll. 

Region is already In-Hotion-In. 

cached region is initiated.) 

HO. 

Region is In-Hotion-Out. (Set by STRRTOBJURITE uhen performing 

the background post of a cached region.) 

This disc donain uas not present and had to be prtfttchtd. 
LOCK . Not used. 

Forced Urite In Progress. Region uas forced out of nenory to 

nake roon for another object. 

ROC. 

Recover Cverlay Candidate. Region nay be forced out of nenory 

to nake roon for another object. Houevtr, if thit region is 

referenced again it can be recovered. 

VIRGIN . 

Clean region in the urite etate. Cleared as soon as a novo 

conpletes. (I.e., if this bit is on, then a urite can conpletc 

inntdiately. Otheruiss the urite uill have to uait until tht 

current urite conpletes the physical post.) 

(8:1) - NOPQST . t m 

Set uhen the CDT is being posted out as a result of a urite 
request that did not uant to uait for the phyeical post to com- 
plete. This uill be cleared by the cache conpletor uhen tht 
physical post conpletes. (This is ussd to insure that a cache 
neve for any subsequent urite request uill not bs ssrvicsd un- 
til the physical post conpletes.) 

(9*1) - SEQ . 

Set' if doing sequential I/O. Uhen the request for the last 
area of this disc donain is conpletc, this donain uill be nadt 
a ROC. 

(10:3) - Not used. 
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Happed Donain Entry 

| 1 

0| PREV HAPPED DOHRIN ENTRY (ENTRY MUHBER) I CDT'HD' PREV 

| 1 

1| NEXT HRPPED DOHAIN ENTRY (ENTRY NUHBER) I CDT'HD 'NEXT 

| 1 

21 START SECTOR I CDT'HD' SECTOR 

I* "! 
I RDDRESS I 

| 1 

4| LAST SECTOR | CDT'HD' END 'SECTOR 

•- "! 

I RDDRESS I 

| 1 

61 A| I| I| HI LI F| R| VI N| SI J S ICDT'HD'FLAGS 

I 81 H| HI II 0| U| 01 II 01 El I T | 

| SI II 01 SI CI II C| R| PI 01 | A I 

I El I I SI X| P| I Gl 01 | I T | 

I H| | | | E| I I II S| I I E I 

I T| | I I D| I I N| T| | | | 

| 1 

7 1 II RERDS PENDING I CDT'HD' READ 'CNT 

1 

101 N URITES PENDING I CDT'HD' URITE 'CNT 

| 1 

111 LOCK URITING ICDT'HD'LKD'CDT 

| 1 

121 HERD OF inPEDED LDR ICDT'nD'MPED'HD 

, 1 

131 HERO OF ACTIVE LDR I CDT'HD* LDR' HEAD 

j 1 

14| HEHORY RDDRESS ICDT'HD'HEH'RDR 

|- -I 

| IF PRESENT I 

, 1 

161 DRQ FOR THIS HAPPED DOHAIN ICDT'HD'DISCREQ 

| 1 

17| « FLUSHING CDT' S ICDT'HD'LK'CNT 

| 1 

20| LDEV FOR THIS HAPPED DOHRIN (CDT'HD'LDEV 

| 1 

211 HEAD IHPEDED QUEUE (PIN) ICDT'HD'IHPEDED 

| 1 

221 DEVICE ENTRY (ENTRY NUHBER) ICDT'HO'DE 

| 1 

23| | | COT' HD* DEFERRED 

| ENTRY LENGTH I 

3,j 1 
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(13:3) - STATE 

- AVAIL CDT is *n available entry. 

1 - RERD. Only read LDR(t) art attached. 

2 - URITE. Urite LDR(s) and possibly read LDR(s) art 

attached. 

3 - FLUSH. COT is being flushed out. 

4 - LOCK. Unused. 

CDT'HD 'RERD' CNT 

Tht nunbtr of LDRs attachtd that art for reads (novo not conplttt). 

COT'nD'URITE'CNT 

Tht nunbtr of LDRs attachsd that art for urittt. NOTE: This count uill not 
bt decrenented until both the cache novo and the physical urite conpletes. 
Houever, as soon as the cache novo conplttts, the LDR uill be dequeued fron 
the CDT. 

COT'HD'LKD'CDT 
Not used. 

CDT'HD'IHPED'HD 

The first LDR that is inpeded. (I.e., the CDT is in a urite state already and 
anothtr uritt is attached. The second urite uill be placed in this queue un- 
til the first urite conpletes.) 

CDT'HD' LDR' HEAD 

Tht first LDR that is on tht activt list for this CDT. 

CDT'HD'HEH'ADDR 

Tht ntnory addrtss (region base) for this napped disc donain, if present. 

CDT'HD'DISCREQ 

The disc request table indc» associated uith this napped disc donain. This 
uill be used to fetch this region in, or to post this rsgion after any logi- 
cal I/Os (urites) have conpleted. (I.e., this DRQ is used for the physical 
I/O.) 

CDT'HD' LK' CNT 
Not ussd. 

CDT'HD'LDEV 

The Ldev nunber for this napped donain. 

CDT'HD 'IHPEDED 

The PIN for the first procsss inpeded on this napped disc donain. Processes 
get inpeded here uhen they do URITFORIO uhen their LDR le on the CDT inpeded 
queue and the Happed Donain is currently being uritten out. (This uill also 
happen upon a :STOPCACHE to force all LDRs to conplete.) As soon as the 
physical post of the Happed Donain is conplete, all processes inpeded here 
uill be auakened. 

CDT'HD'DE 

The entry nunber for the Device entry that this Happed Donain entry is as- 
sociated uith. 
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Logical Pm *«Q"fft *«M« 

11017 Pointtr to logical Oitc Rtquttt Table 

KOTE: This tablt it really pert of tht DRQ (rtfer to Chapter 13). Rny tntry 
uith tht logical requett bit ttt in tht flagt will conforn to this for- 
nat and not tht fontat of tht atandard DRQ. 

Logical disc requtttt tntritt art uttd to nanagt rtqutttt bttuttn tht 

requesting procttt and a napptd disc donain. Thty art tht counttrpart of 
disc rtqutttt tntritt uttd to nanagt phytical I/O rtqutttt bttuttn a procttt 
and a due. Thttt tntritt art ktpt at part of tht DRQ Tablt, but uill ntvtr 
bt qututd to tht ditc't DIT, intttad thty uill bt qututd to tht napptd ditc 
donain COT tntry. LDR tntritt n*y only bt plactd onto tht follouing qututt: 

1. Tht COT activt litt. 

2. Tht COT inptdtd LDR litt. 

3. Tht Disabled Oitc Rtquttt. (Thit uill only happtn if tht bufftr ttgntnt 
it abttnt uhtn tht logical I/O (cacht novt) it atttnpttd.) 

NOTE: LDRt art tingly linked onto tht COT qututt and doubly linktd onto tht 
ditabltd ditc rtquttt qutut. 



rtPC Ditc Caching 
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LDR* FLAGS 
Flagt. 

(0:2) 

Not uttd. 
(2:1) - ORQREQ 

Sttif LDR cauttt a physical I/O. 
- SBUT . 
Stt if rtquttt it to/f ron a Sytttn Bufftr. 

• IOUftKE . 
Stt if tysttn thould uakt up tht procttt 
uhtn tht logical 1/0 conpltttt. 

• BL0CKE0 . 
Stt if tht procttt uantt to uait for tht 
logical ditc rtquttt to conplttt. 

• DONE. 
Stt uhtn tht logical ditc rtquttt it conplttt 

and tht procttt uill bt auaktntd (if IOURKE it ttt) 
(7:1) - DO' POST . 

Stt if tht cailtr uantt to bt uaittd until tht phytical 

pott to ditc conpltttt. Only valid for uritt rtqutttt. 
(8:1) - SEWl/POST. 

Stt uhtn tht phytical pott thould bt 

through tht Global Strial Uritt qutut. 

(9:1) - cprquEKp. 

Thit rtquttt hat bttn qututd tithtr 

onto tht COT aetivt qutut (ttt CDT ttapptd Donain tntritt) or 

onto tht ditabltd ditc rtquttt litt. 
(10:1) - ROVE' DONE . 

Tht novt hat bttn conpltttd, but 

tht procttt uon't bt auaktntd until tht DONE bit it ttt. 
(11:1) - Not ustd. 
(12:1) - CUR'REO . 

Stt if thit rtquttt it tht currtnt/activt 

rtquttt. 
(13:1) - DISABLE . 

Stt if tht rtquttt it ditabltd. 
(14:1) - LDR'REO . 

Stt if thit it a logical ditc rtquttt. 
(15:1) - LDR'INIOC . 

Stt if napptd Donain COT tntry it in 

procttt' t locality litt. 

LDR'L'HODR 

lht Hioh Crdtr Oitc Rddrttt of tht extent Unit. 

(Set note with LSR'B'HODA.) 

LDR'lDEV 

Tht Liev for thit rtquttt. 

LDR COT 

Tht „:T nunber for tht flapped Donain tntry attociattd uith 

thit request. 

LOR'B'JFCST 

Data Segntnt nunbtr for tht target of the logical I/O rtquttt. 

If bit «ro is stt, then this is the procssi's stack. 
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Looieal Dite Reauest Entry 



1 2 3 4 5 6 7 B 9 10 11 12 13 14 15 

|„|..|~|~|-|"|--|"I"|--M"|--I"I--|--I 

01 SI II Bl 01 01 SI CI HI | CI 01 LI IILDR'FLRGS 

R| 81 01 LI 01 01 El 01 01 I lit II 01 N| 

Ql U| U| 01 H| | R| T| V| | R| S| R| 

R| F| fl| C| El P| II I I I I HI I U 

El I K| K| | 01 R| Ql 01 I Rl 81 Rl 0| 

I Q| I El El I SI LI Ul 01 I El U El C| 

| | | | I I 01 1 T| I CI Ml I Q| C| Ql I 

I I I I I I I El I I Dl I I 



^P»v 



,..l-l.-l--l-l--l-l-l-l-l-l-l--l-l--l--l 



1 1 HOOR OF EXTENT LIMT 
I- 



2| LDEV 
I- 



3 1 nRPPED DOflRIN COT ENTRY NURBER 
, „ , 

4 | S| OST NUHBER 
|„| 

5 1 OFFSET INTO OST 
I- 



STRRTEGY 



FUNCTION 



7 | COUNT/XLOG/CONTROL RETURNS 
I- 



ILDR' 
-I 

I LOR' 
-I 

I LDR 1 
-I 

I LDR' 
-I 

I LDR' 
-I 

I LDR' 
-I 

I LDR' 



L'HODA 

LDEV 

CDT 

BUFOST 

6UFRDR 

STRRT'FUNC 

COUNT 



101 PI 



I- 
111 P2 

121""*""""" ^ 
131 PIN NUHBER 



I LDR' 
1 1 1 

I QUALIFIER I STATUS I LDR' 
1 J 1 

I LDR* 



ILDR'PARm 
-I 



-I 



14| PREV. LDR IN QUEUE (TABLE RELATIVE) I LDR' 

I 1 

151 NEXT LDR IN QUEUE (TABLE RELATIVE) ILOR' 



I- 
161 KOOA OF EXTENT BASE 



I- 



17| LODA OF EXTENT BASE 
201 LOOA OF EXTENT LMIT 



-I 

I LDR 
-I 

ILOR 






I- 



ILDR' 
-I 



PARR2 

STATQ 

PCB 

PREVQ 

NEXTQ 

B'KOOA 

8' LODA 

L'LODA 
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FtPE Ditc Caching 



LDR'BUFROR 

Offttt uithin tht DST (above) for tht target address. If the 

DST it tht procttt' ttack, thtn thit address uill be DB rtlativi 



LDR' STRRT'FUNC 






(0:8) - 


Strategy 







1 


- Unknoun cailtr 

- Unknoun Filt Sytttn 




2 


• Spooltr 






3 


- Dirtctory 






4 


- Dite Frtt Spact 




5- 


'- Unknoun cailtr 




8 


- GENflESSRGE 






9 


- Filt Sytttn, 


Quittct I/O 




10 


- Filt Sytttn, 


Sequential, 


No Buf 


11 


- Filt Sytttn, 


Direct, No Buf 


12 


- Filt Sytttn, 


Stqutntial, 


Bufftrtd 


13 


- Filt Sytttn, 


Oirtet, Buffered 


14 


- Filt Sytttn, 


KSRfl 




15 


- Filt Sytttn, 


iriRGE 




(8:8) - 


Function 









- Rtad 






1 


- Uritt 







LDR' COUNT 

On initiation, thit specifies tht requested trantftr count (*uordt, -bytet). 
At cenplttien of tht rtquttt, thit contains tht actual transnission count 
(♦words, -byttt). 

LDR'PARHI 

Thit it tht High Order Ditc Rddrttt of tht requested ditc sector. 

LDR' PARK 

Thit it tht Lou Order Ditc Rddrttt of tht rtquttttd ditc ttctor. 

LDR'STRTQ 

Uniforn status rtturnt. 

LDR'PCB 

PIN of tht rtquttting procttt. 



H^ 



G.23.00 
23- 18 



/^N 



/^^N 



APE Disc Caching 



LDR'PREVQ 

Table relative index of the previous LDR in the queue. (MOTE: LDRt art sing- 

ly linked en tht CDT queut t, and doubly linked on the disabled disc request 

qutue). 

LDR'NEXTQ 

Table relative index of tht ntxt LDR in tht qutut. 

The High Ordtr Disc Address of tht txttnt base. (Used uhtn tht logical disc 
request is through tht file system Caching uses this data uhtn searching 
nenory for a "hit" on a cached donain). 

LDR'B'LDOfl 

The Lou Order Disc Address of tht extent base. 



(See note above. ) 



ftPE Disc Caching 



CHAPTER 24 NB TTVF LANGUAGE SUPPORT 
ML/3000 Internal Table Stnicturt 



NLS FILE CODES 

LRNGOEF.PUB.SYS - 1228 

CHRDEFXX.PUB.SYS - 1229 

NLSDEF.PUB.SYS - 1229 



LDA'L'LODA ,„ u . 

The Lou Order Disc Rddrtss of tht txttnt Unit. (Stt nott abovt.) 



Native Language Support ( MLS \ Table Overvieu 



I 
— >| LANGUAGE 
I DST 
I 



I — I 

| SYS OLOB EXTN Z12 |- 
I I 



>l 
| NATIVE 
I 

I LANGUAGE 
I 

I TABLE 
I 



I 

I 
- — >| LANGUAGE 

I DST 
-I I 

I 

I I 

I I 

|«>| LflNGURGE 

I DST 

I 

I 
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Native Language Support 

Matjv, Lanmiaot Table (ALT) 

This tablt is crtattd by INITNLS (calltd by PROGEN). Tht DST nunber is con- 
tained in SYSGLDB extension X12. The Native Language Table (NLT) contains 
the description of all tht character sets nttdtd to support tht installed 
languages, and additional infornation needed to support the configured lan- 
guages (DST nunbers of the languages associated DSTs, characttr stts, etc. J. 

Every installed language has an associated Language DST, as set up by 
INITNLS. 



NLT OVERHEAD TRBLE 



NLT INSTALLED LANGUAGE 
TRBLE 



NLT INSTALLED CHARACTER 
SET TRBLE 



NLT CHRRRCTER ATTRIBUTE 
TRBLE 



Native Language Support 

NLT Installtd Language Ta ble Fornat 

For each supported non-NRTIVE/3000 languages there is a 12-uord language 
entry. 



NLT Overhead Table 
The NLT overhead tablt is eight (8) words long. 



LANGUAGE ID NUHBER 



l<-| 



LANGUAGE CLASS 



I 



LANGUAGE LOST NUHBER 
CHARACTER SET ID NUHBER 



>-1st SUPPORTED LANGUAGE 
ENTRY 



LANGUAGE NRHE 
I (8 UORDS) 
X13I 
I 

I 



1 



-I- 



LENGTH OF NLT (IN UORDS) 



NUHBER INSTRLLED LANGUAGES 



NUHBER INSTRLLED CHRR SETS 



5 SYSTEH LANGUAGE ID NUHBER 



SYSTEH LANGUAGE LDST 
NUHBER 



7 RESERVED 
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LANGUAGE 10 NUHBER 



LANGUAGE CLASS 
LANGUAGE LDST NUHPEA 
3| CHARRCIER SET ID NUHBEA 



Z13| 



LANGUAGE NAHE 
| (8 UOADS) 



-Nth SUPPORTED LANGUAGE 
ENTRY 



I I 



l<-| 
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Nativt Languagt Support 

Mi,T ] n «tilltd Characttr Stt Tablt Forwat 

For tach characttr ttt inttalltd on the tysttn thtrt it an 11 uord character 
ttt tablt. It hat tht following fornat: 



CHARACTER SET TYPE 



0| CHRRflCTER SET 10 NUNBER 

I- 
II 

I- 
21 

I 

I 
31 

I 



POINTER TO CHRRflCTER 
ATTRIBUTES TABLE 



I 
Z12I 



CKRRRCTER SET HMt 
(8 WORDS) 
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Native Languagt Support 

U\J Characttr R ttnbuttt Tablt 

Tht NLT Characttr Attnbuttt Tablt it conprittd of a tablt for tach con- 
figurtd characttr ttt. At thit tint, only tuo characttr tttt art configur- 
able Class Four Languages (KANJI-bastd) and Nonclast Four languages. 



I 1 

| CHAR SET « 1 | 

| ATTRIBUTES I 

! 1 

| CHAR SET N 2 | 1 

| ATTRIBUTES I I 
| 1 | 

i 1 I- 

! ! 



CHARACTER TYPE • 1 

I 1 

->| 256 bytt I 
| ATTRIBUTE I 
I TABLE I 

I 1 

CHARACTER TYPE « 2 
| 1 

->| 8 UORD KANJI | 
I ATTRIBUTE I 
I TABLE i 

I 1 



Tht typt - 1 attributt tablt it a 256 bytt tablt. 
characttr uith that oetal valut. 



Each bytt corresponds to a 



Attributt 
1 
2 
3 
4 
5 



- Nuntric character 

- Sptcial characttr (i.t., , "?". ".") 

- Alphabttic upptrcast characttr 
• Alphabttic loutrcast characttr 

- Control codt 

- Invalid characttr (unustd codt) 



Nativt Language Support 



iwqy'qt P?T 



For tach language installed on a target systtn (uith the CKception of 
HATIVE-3000) INITNLS uill build one language DST uith the following 
structure: 



| 

I LOST OVERHEAD TABLE 

| LOST TRANSLATION TABLES 
I (5 SUBTABLES) 

I LOST CUSTOH OATA TABLES 
I- 



LOST NATIONAL SPECIAL 

TABLE 

(AN OPTIONAL TABLE) 
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Native Language Support 



LOST Ovtrhead Tablt 
The overhead region hat tht following fornat: 

0| "L" | "D- j 
I 1 



11 



I 



| 1 

2| LOST SIZE IN WORDS 
, 

31 NLT DST NUHBER 

I 



<! 



LOST OFFSET TO CUSTOfl 
DATP TABUS 



I 

51 LOST OFFSET TO NATIONAL 
I SPECIAL TABLES 






The national tptcial tablt it optional. If it dott not exist, the pointer to 
it it ztro. 
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Native Language Support 



LOST Translation Tables 



For each language several translation tables arc stored: 



^rns 



I LOST UPSHIFT TABLE 
| (128 UORDS) 



| LOST DOUNSHIFT TABLE j 

| (128 UOROS) | 

| LOST ASCII -> EBCDIC I 

| CONVERSION TABLE I 

| (128 UOROS) I 

| 1 

| LOST EBCDIC -> ASCII I 

| CONVERSION TABLE | 

I (128 UOROS) | 

| 1 

| LOST COLLATING I 

| SEQUENCE TABLE I 

| (CLASS OEPENOENT) | 



G.23.00 
24- 8 



a&*\ 



Native Language Support 



^$T foliating Sequence Table 

The LOST Collating Sequence Table ie of different fornata depending upon the 
class of the language. 

Overview 

Class One Sone languages, nanely Rneriean English and Katakana, can be be 
Languages: collated by using the numerical representation of the ASCII en- 
coding as the sequence nunber for any given character. These 
languages can use the Conpare Bytes nachine instruction. 

Class Tuo Sone languages nay be able to use the COBOLII nachine inst rue- 
Languages: tion, Conpare-Translated-Strings. These languages need to have a 
one-to-one napping of character encoding to sequence nunber. Any 
algonthn for this class of language nust take into account the 
fact that not every HP 3000 has COBOLII firnware. 

Class Three flany languages uill not be able to use either of the tactics 
Languages: described above. There are a nunber of language-dependent al- 
gorithm that need to be supported. 

Class Four Sone languages require 16-bit character string encoding. 
Languages: Collating these languages is not supported. The collating se- 
quence table for this class of language is reserved. 

Class One Languages 

Since class one languages uill use the conpare bytes nachine instruction 
(CRPB), the whole collating sequence table for this class is 3 words. 



of" "" "3" I 

1 | LANGUAGE ID I 

2 1 LANGUAGE CLASS I 
| 1 
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Native Language Support 

Class Two Languages 

This sequence table has a 13-word over head table and a 128-word sequence 
table. 



Native Language Support 



Class Three Languages 



TABLE LENGTH (UORDS) 



12 
13 



139 



LANGUAGE ID 
LANGUAGE CLASS 
11 
128 



LOWEST CHAR. | HIGHEST CHAR. 
SEQUENCE VALUE I SEQUENCE VALUE 

RESERVED 
1 

SEQUENCE » I SEQUENCE N 1 
SEQUENCE » 2 I SEQUENCE » 3 



-I- 



-Overhead table 



>-Sequence table 



r 



2121 SEQUENCE N 254 | SEQUENCE N 255 |< 1 

, 1 - I 



Note: Uord X11 of the overhead contains in the left byte the chara.tsr 
value, which has the lowest sequence nunber and in the rignt by* the 
character value, which has the highest sequence nunber. 

In the 128-word sequence table, the byte value of the character is 
used as a byte pointer in the collating table. 

The byte value of the character is used as a byte poi-ter roil.ting 
entries. 
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LANGUAGE ID 
LANGUAGE CLASS 



11 
~256 

POINTER TO 2:1 HAPPING TABLE 

LENGTH OF 2:1 HAPPING TABLE 

POINTER TO 1:2 HAPPING TABLE 

LENGTH OF 1:2 HAPPING TABLE 
-I— 



LOUEST CHAR. I HIGHEST CHRR. 
SEQUENCE VALUE I SEQUENCE VALUE 

12 j RESERVED 

SEQUENCE ENTRY i 



SEQUENCE ENTRY • 1 



>-Overhead Table 



13<- 

I 
I 
I 

I 

I 

1 J - 

3701 I SEQUENCE ENTRY • 255 |< 
I , 1 

I I 2:1 CHARACTER HAPPING TABLE I 

I I 1:2 CHARACTER HAPPING TABLE I 

I 

I >l 



< 1 

< 1 

I 
I 



>-Scquence table 
I 
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Native Language Support 
Clan Three Lineman (Cent.) 



I nooE 1 

111111 

1 2 3 4 5 6 7 S 9 1 2 3 4 5 
| 1 — | 1 

| o I I I Thett character! uill 

| ........_ — -|— |— — — — | be ignortd when sorted. 



0123456789012345 

| 1 — | 1 fill 1:1 napping 

I SEQUENCE « I I | character! 

j———— 1 — | ........... | githout cast or 

aectnt priority 

OR 
0123456789012345 

| 1 — | 1 1:1 napping 

I SEQUENCE • I | PRIORITY I character! uith 

j -- j — j j case or accent 

priority 

OR 
0123456789012345 

f "SEQUENCE ■ I 1 I INDEX I 2:1 napping 
j j — | 1 character! 

OR 
0123456789012345 

I SEQ. « OF 1. | 2 I INDEX | 1:2 napping 
j ............... j — j — — — — | character! 



The byte value of the character ie used ae an index to the sequence entnee. 
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Native Language Support 



1:2 Character nacpine Table 



|1:2 RAPPING ENTRY | — 



111111 
0123456789012345 
, 1 j 

0| SEQ.i Of 2ND I RODE OF BOTH I 

1 | SEQ.N OF 2ND I RODE OF BOTH I 

N| SEQ.I OF 2ND I NODE OF BOTH I 
, 1 1 



I— 



— nODE • 



— I 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I— I— I— I— I— I— I— I— J— I— I— I— I— I— I— I— J 



I- 



| 



- INDEX/TYPE 
PRIORITY 
(BITS 10:6) 



— nOOE TYPE (0,1, OR 
(BITS 8:2) 



Entry hae earn fornat ae one above. 



G. 23.00 
24- 14 



Native Language Support 



2:1 Charaef r flapping Table 
I 

\ 1 

|2:1 HAPPING ENTRY I > 

I 1 



111111 
0123456789012345 
, 1 

0| I LEGAL CHAR 1 

11 SEQ.N OF PRIR I RODE OF PAIR 



(N-1)*2| 



-I 

I LEGAL CKRR N 



-I- 



(N-1)*2*1| SEQ.N OF PRIR I RODE OF PRIR 
, 1 

n*2| -1 

, 1 

H*2*1| IRODE NON HATCH 
| 1 



I- 



. hooe — 



-I 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
IHHHH--I--I--MH--MH--I--I--I--I 
I II 

, , , , 

| | IHDEX/TYPE 

| PRIORITY 

| (BITS 10:6) 

| nODE TYPE (0,1, OR 

(BITS 8:2) 



Cntry has sane fornat as node options in the LOST Collating Sequence Table 
Fornat for Class Three Languages. 
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Native Language Support 



ttass Foyr Ungues 



Class four languages require 16-bit character encoding. Sorting in class 
four languages is not inplenented in this release of NLS. A preliminary col- 
lating sequence table is planned to be 8 uords in length. 



I 

Oi ADDRESS ON DISC 

1 | ADDRESS ON DISC 



1 

• PATTERN 1 | 

• PATTERN 2 I 



7 | RDORESS ON OISC - PATTERN 8 I 
, 1 
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Native Language Support 

LOST Cutton Data Table fornat 

This table is 196 uords long. Tht fornats and information in this table art 
language dependent, and n*y ba nodified with UtNGINST.PU6.SYS. 



0| LDST CALENDAR SKELETON 
| (9 UOROS) 



111 LOST CUSTOH DATE SKELETON 
| (13 BYTES) 



20 1 LDST TIflE SKELETON 
| (4 UOROS) 



116 



I- 



24 | LDST RBBREVIRTED nONTH NflltES I 20 
| (24 UOROS) 

54 | LDST FULL NONTH NRrtES 44 

| (122 UORDS) 
| 

164 1 LDST ABBREVIATE UEEKDRY NAIIES 116 
I (21 BYTES) 



1771 



LDST FULL UEEKDRY HARES 
(42 UORDS) 



251! LDST YES/NO CHARACTER STRINGS 169 
I (6 UORDS) 



257| 



I-— 



LDST THOUSANDS INDICATORS 
(1 UORD) 

LDST CURRENCY SYWQL 
(5 BYTES) 



260 1 

I 

I- 
263 I LDST RESERVED 



I- 



1127 



175 
176 
179 
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Native Language Support 

National Dependent Table Fornatt 

I0| LENGTH OF TflBLf (UOROS) I 

Z1| ID I 

, 1 

Z2| NUI1BER OF ENTRIES I 

, 1 

13 | HUH OF HP SUPPLIED ENTR.I 

, 1 

X4 ♦ Z5| PERIOD ENTRY 1 | 
| 1 

(2n*2) *| PERIOO ENTRY n ! 
(2n43) | 1 

The period entries are tuo uord entries of tht following fornat: 

6 7 15 

| "YEAR OF I DRY OF THE I UORD 1 (STARTING DATE) 
| CENTURY | YEAR I 
, , 1 

7 8 15 
I I 1 

| STRRTING I EUPEROR I UORD 2 
| YCRR | S v iBOL I 
, 1 1 

The ID for Japanese and Taiwanese date f ornate is always set to 1. 
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Native Language Support 



LOST National Special Table 

Thxs table is optional and its existence is signaled by a nonzero pointer in 
the LDST overhead region. It is used to store data unique to a given language 
(e.g. the Enperor data for the Japanese calendar). 

I LENGTH I 

| J 

| NATIONAL I 

| DEPENDENT I 

| DATA I 

| 1 



Date Fornats for Japan and Taiuan 

For a given language, there is only one date fornat possible. The fornat of 
the yttr stored in the date fornat of the LDST can either be yyyy or yy for 
the Julian dates or Nyy for either the Japanese date (Enperor Era) or the 
Taiwanese date foundation of republic date). 

If the fornat of the year stored as the date fornat in the LDST is Nyy then 
either the Japanese enperor dates or the Taiwanese foundation date has to be 

stored in the national dependent table. 
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Native Language Support 



J«P«"W P«t« Fornax 



There are thret tntritt which do not change. The user can add neu entries. 
These tntrite have to bt stored in ascending order sorted by uord 1. 



Tht values of tht tntrits are: 

Starting Datt Octal Value Starting Enperor Synbol 
(HDY) year 



1/ 1/1873 


11 


Z41 


n 


7/30/1912 


Z14324 


X1 


T 


2/25/1926 


Z32547 


11 


s 



* Since this starting tine ie in the 19 th century and ue are not 
ablt to handle datte before 1900 easily, ue store 21 as starting 
tint. 

For neu datt tntritt created by the c us toner tht starting ytar 
uill always bt 1. 



Taiwanese Date Fornat 

There are tuo tntritt for tht Taiuanttt national dependent table. 
Tht valuta of tht entries are: 



Starting Datt 
(HDY) 

1/ 1/1900 
1/ 1/1912 



Octal Value Starting Enperor Synbol 
Year 



Z1 
Z14001 



ZO 
Z1 



Z40 
Z40 



The uttr dots not need to add new entries. 
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RTP/RTP37/RDCC 



CHAPTER 25 RTP/RTP37/RDCC 



This chapter contains a description of thi nonitor/printer DIT and tablet in 
the ttminal data stgntnt (70S) uttd by tht HPE V/E RTP/RTP37 and RDCC ttr- 
ninal drivers. 



Terninal Data Stgntnt Fomatt 

RTP/RTP37 Ttminal Data Stanent Fornat 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|-..|..-|...|~-|...|— | — I — I— I— I— I — I — I — I — I — 
°i 
42 1 TERMNRL ORTR SEGflENT HERDER - Z43 UOROS 

242 | HARDWARE DIT POINTER TRBLE - Z200 U0R03 



I- 
243] 

646 1 VFC TRBLE - X404 UORDS 

, 

647] 

732 I RTP KRRDURRE DIT FOR UNIT - Z64 UORDS 

733] 

752 1 CONTROL PR0GRRI1 RRER FOR UNIT - Z20 UORDS 
, 

7531 



767| PROTOCOL RND DRTR ItflNRGER FIXED DIT FOR UNIT - X15 UORDS 
| 

770] 

11031 PORT PROTOCOL DIT FOR UNIT - X114 UORDS 

| 

1104] 

11361 PROTOCOL RNO DRTR URNRGER VRRIRBLE DIT FOR UNIT - Z33 UORDS 



I- 
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RTP/RTP37/RDCC 



WW Tt"M P^f SfWt F °™«t 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

,_,_|_|-.|..-|-.-|..-|.-|— |— I— I— I— I— I— I— I 

0] ] 

42| TERMNRL ORTR SEGflENT HERDER - Z43 UORDS I 

! 1 

242 KRROURRE DIT POINTER TRBLE - Z200 UOROS I 



243 



646 I VFC TRBLE - Z404 UORDS 



-I 



647] ] 

10101 RDCC KRRDURRE DIT FOR UNIT - Z142 UOROS I 

1011] ] 

1025 I PROTOCOL RND ORTR URNRGER FIXED DIT FOR UNIT - Z15 UOROS I 
, 

1026] i 

1141 | PORT PROTOCOL DIT FOR UNIT - Z114 UOROS I 

, 

1142] ] 

11741 PROTOCOL RND DRTR fWHRGER VARIABLE DIT FOR UNIT - Z33 UOROS j 

"] 
I 



1175] 

15221 OIT'S FOR UNIT 1 - Z326 UORDS 



I DIT'S FOR UNIT N - X326 UORDS 
, 
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RTP/RTP37/RDCC 

RTP/RTP37 Terninal Data S ea»*nt Fornat (ContJ 



j 

1137] 

14261 DIT'S FOR UNIT 1 - Z270 UORDS 



| DIT'S FOR UNIT N - Z270 UORDS 



I 



I PCC DUflP RRER - Z400 UORDS 
| 



I 



RESSRGE TRBLE - ZS3 UORDS 



I- 
] 

| PORT ERROR OUflP RRER • Z2424 UORDS 
, 

] 

I T6UF TRBLE HERDER - XI 2 UORDS 



I- 
] 

| TBUF'S - Z105 UOROS ERCH 



Fixtd ovtrhtad it Z3760 uordt. Overhead per logical dtvict it Z270 uordt. 
Each TBUF it Z10S uordt. 

For RTP37t there it ont data tegnent created for tach channtl (DRT) that con- 
taint an RTP37. For RTPt thtrt it at ltatt ont, naybe tuo data tegnentt 
created for tach channel (DRT) that containt an RTP. Devicet configured be- 
tween unite 0/47 »n in one data tegnent and if devicet »rt configured be- 
tween unite 48/95 they are in a tecond data tegnent. The addrettet for the 
data tegnent(t) trt contained in the firet tix uordt of the ILTK for the 
channel. If there it a tecond RTP data tegnent then the data tegnent addreti 
ie in the tecond eix uordt of the ILTX. 
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RDCC Terninal Data Seanent Forwat (Cont.) 



, 

] 

I HESSRGE TRBLE • Z53 UORDS 
j 



| PORT ERROR OUflP RRER - Z2424 UORDS 
| 

] 

I TBUF TRBLE HERDER - Z12 UORDS 

| 

I 



TBUFS - Z105 UORDS ERCH 



Fixed overhead it Z3360 uordt. Overhead per logical device is Z326 uords. 
Each TBUF it Z105 uordt. 

For ROCCt there it one date eegttent created for all configured RDCC devicet. 
It uill contain the tablet for a naxinun of 64 configured device*. The ad- 
dreee of the data tegnent ie in tht first eix uordt of the ILTX. 
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Terninal Data Seonant Tablet 



Terninal Data Seewent Header Fornat 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

,. H ...| — | — | — | — | — |— | — | — | — | — | — |— | — |— | 
Z0| TERMNRL DRTA SEGHENT VERSION NUHBER I 

„_ ^ 

1 

I 



1 | TDS RELATIVE POINTER TO HRRDUARE OIT TABLE 

2ITMRELATIVE POINTER TO T8UF TABLE 

3ITDSRELATIVE POINTER TO VFC TABLE 

4 1 TDS RELATIVE POINTER TO 1ST HRRDUARE DIT 
I- 



5 1 TDS RELATIVE POINTER TO 1ST DEVICE URITING FOR A T6UF I 
| 1 

6 1 TDS RELATIVE POINTER TO LAST DEVICE URITING FOR R TBUF | 



7 | DRT NUHBER OF CHANNEL - ATP/ATP37 ONLY 
101 LOUEST LOGICAL DEVICE NUHBER IN TDS 



111 HIGHEST LOGICAL DEVICE NUflBER IN TDS 



121 RIB POLL HAS* - ATP/ATP37 ONLY 



I- 



131 TDS RELATIVE POINTER TO HESSAGE TABLE I 

| 1 

14| TDS RELATIVE POINTER TO PCC OUHP AREA - ATP/ATP37 ONLY | 
| 1 

151 TDS RELRTIVE POINTER TO PORT ERROR DlfflP RRER I 

| 1 

161 LOUEST LOGICAL DEVICE CONFIGURED ON CHANNEL - ATP/ATP37 ONLY I 



I- 



17| HIGHEST LOGICAL DEVICE CONFIGURED ON CHANNEL - ATP/RTP37 ONLY I 
| 1 

20| STATUS UORO OF TOS UHEN IT UAS BUILT - ATP ONLY I 



21 i STATUS UORD OF TDS UHEN IT UAS INITIALIZED - ATP ONLY 



22 I STATUS UORD FOR DIAGNOSTICS 



I- 
23 1 
24 | VERSION NUHBER OF LPHON 

, 
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RDCC Hardware DIT Pointer Table Fornat 



ATP/ATP37/ADCC 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

|— |— |— |~|~|~|~-|~ 1—|— |— |— |— |— I— |— j 
0| DRT NUHBER OF 1ST DEVICE I 



1 | TDS RELATIVE POINTER TO 1ST RDCC HARDUARE DIT 
, 

2 1 DRT NUnBER OF 2ND DEVICE 

3 1 TDS RELRTIVE POINTER TO 2ND RDCC HAROURRE DIT 
, 

I 



I- 



1761 DRT NUHBER OF LAST DEVICE 

177| TDS RELATIVE POINTER TO LAST ADCC HARDUARE DIT 
, 



1 



This table, uordt Z43/Z242 in the data aegnent, contains a data segnent rela- 
tive pointer to the hardware DIT for each device configured. The table alto 
contains the DRT nunber of the device. If the device ie not configured the 
pointer and DRT nunber uill be a ninue one. 

VFC Table Fqrnat 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I — |— 1_|—|— i — i — I— i— i— i— i— i— i— i— i— ! 

"«i i 



-1 | VFC TABLE SIR 



I- 
°i 
17 | VFC ENTRY 



I 

I- 
3601 



377| VFC ENTRY 15 
I 
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Terninal Data Sequent Hudtr Fornat (Cont.) 



| 

25 1 

26 1 VERSION NUHBER OF TERHHON 



I- 



30 1 VERSION NUHBER OF PHYSICAL DRIVER - ATPDRIVER/ADCCDRIVER 
, 

311 

321 VERSION NUHBER OF IHRNDLER 



I- 

34| VERSION NUHBER OF INITIALIZATION PROCEDURE -ATP/ATP37/ADCCINIT 
| 

351 



361 VERSION NUHBER OF IHANAGER 
| 

37| 

401 VERSION NUHBER OF TERHUTIL 
, 

411 

421 VUUFF NUHBER OF SOFTURRE 



I- 



Harduare DIT Pointer Table Fornat 



ATP/ATP37 Hardware DIT Pointer Table Fornat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

| ... | ... | ... | ... | ... | — | ... | — | — | ... | ... | — | — | — | — | — 
0| TDS RELRTIVE POINTER TO RTP/ATP37 UNIT HARDUARE DIT 



1 | TDS RELATIVE POINTER TO ATP/RTP37 UNIT 1 HRRDURRE DIT 
, 

] 
I 



177| TDS RELATIVE POINTER TO RTP/RTP37 UNIT 127 HAROURRE DIT 
| 



This table, worts Z43/Z242 in the data segnent, contains a data segnent rela- 
tive pointer to the hardware DIT for each unit configured. If the unit is 
not configured the pointer uill be a ninus one. 
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VFC Entry Fornat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

,...,-.|..., — 1...| — | — ,— | — | — I— I — I— I — I— I— I 

0] j 

3 I VFC FILE NAHE 



I- 
4 1 

7 | VFC FILE GROUP NRHE 
| 

10] 

131 VFC FILE ACCOUNT NAH.E 
| 

14| REFERENCE COUNT 



I- 
15| TDS RELATIVE POINTER TO TBUF CONTAINING INITIALIZATION STRING 



I- 



161 TDS RELATIVE POINTER TO TBUF UITH VFC O/VFC 7 



I- 



17| TDS RELRTIVE POINTER TO TBUF UITH VFC 8/VFC 15 
| 



G.23.00 
25- 8 



RTP/RTP37/ADCC 



Protocol and Data Aanaeer DITs Fonut 



Protocol and Data nanaeer Fixed PIT Fomat 



1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 



-I — I— I- 



|_..,_..,...,_.., — l-.-l — | — | — | — | — | — | 
0| TERMNAL DST RELATIVE POINTER TO HAROURRE DIT 

| 1 1.-|...|...| — I 1 — I — I— I 

1| ICONTROLlSPDi |UN| |CONNECT| | |BRO|PUF 

| PORTSTRTE ITYPE |SPC| |TYP| | TYPE I I |KEN|FLG| 

, 1 1— | — 1-~ I — | 1...|...|.-.| 

2| CARRIER FAIL CAT | | PS I ADDED SIGNALS STATE 



I- 
31 CARRIER FAIL TMER 



-I — I — I- 



I- 

4 | 2631 8 XON TWER 
| 

5 1 DATA SET READY TWER 



I- 
6 1 DATA TERMNAL RERDY TIAER 



I- 
7 | PORT SPEED IN CHARACTER PER SECOND 



I- 
101 TERMNAL DST RELATIVE PORT PROTOCOL POINTER 



| — 1-.|- 



-|- 



-I- 



-I — I- 



-I- 



11|CHR|PTY| URITE I READ I READ |CLR| I AODEA 
ISIZIENBI PARITY | PARITY) ALT CHARS I FLO I I STATE 
, ... | ... | 1 1 1 — | 1 

121 LINE SPEED IN CHRS/SEC - (DEFAULT) 



I- 



-I- 



131 DEFAULT TERMNAL TYPE NlfflBEA I CURRENT TERMNAL TYPE NUflBER 
14| HARDWARE TYPES 



I- 



9 
9 

10 

11 

12 
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P0'C0NTR0LLER(1).(4:2) 
Indicates tht typt of controller. 

- Unused. 

1 - ATP. 

2 - ADCC. 

3 - Unused. 

PD'SPEED'SPECIFIED(1).(6:1) 

Indicates if the device is to be a speed-specified port. 

- Speedsensed. 

1 - Speed-specified. 

PD'LINETYPE(1).(8:1) 

Indicates the type of line. Currently unused. 

- Asynchronous. 

1 - Synchronous. 

PD'C0NHECTTYPE(1).(1O:2) 
Indicates the type of connection. 

- Direct connect. Device configured as subtype or 14. 

1 - noden connect. Device configured as subtype 1 or 15. 

2 - floeen connect. Device configured as subtype 9 or 13. 

This subtype is for CCITT type ncdens. 

P0'ERDKEH(1).(14:1) 

Indicates if t*»e port is broken. 

- Port is not broken. 

1 - Port is broken. 

PD'?0UERFfiU(1).(15:i) 

Indicates if a pouer fail has just occurred. 

- No pouer fail. 

1 - F:-er fail has juit occurred. 



ATP/ATP37/ADCC 

UORDO 

PD'IOOITP 

Tenunal DST relative pointer to the hardware DIT. 

UORO 1 

PD'PORTSTATE(1).(0:4) 

Indicates the current state of the harduare. This field is set after "start- 
ed" is returned fron the physical driver. 

- Unused. 

1 - Reading. The harduare is transferring data fron the 

device to nam nenory. 

2 - Writing. The harduare is transferring data fron nain 

nenory to the device. 

3 - Idle read. The driver is doing a "dunny read" uhile 

uaiting for the next operation. Only special characters 
Mill be processed. 

4 - Input save. The harduare is currently idle. The harduare 

is saving read characters to be processed against the next 
read, unte or idle read. The Interrupt flanager cannot be 
called by the physical driver uhen in the input save state. 

5 - Unused. 

6 - Unused. 

7 - Unused. 

8 - Unused. 

9 - Selftest. The harduare is currently doing a selftest. 

10- Speedsensing. The harduare is currently uaiting to 
speedsensc the port. 

11- Set port protocol. The port protocol is currently being 
set up. This includes: 

- XON/XOFF enable/disable 

- 7-bit/8-bit characters 

- ff enable/disable 

- Input parity enable/disable 

- Output parity type 

- ENQ/ACK characters and block count 
• Delay characters and delay count 

- Linespeed 

12- Set special characters. The read, read secondary, 
urite, and urite edit special character sets are 
currently being set up. 

13- noden control. The noden interface, input, and output 
control lines are currently being set up. 

14- Unused. 

15- Unused. 
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UORD 2 

PD'CF'CNT(2).(0:6) 

Indicates the nunber of tines DCD has gone off during a read. This is incre- 
nentcd by the Interrupt flanager each tine there is a carrier fail during the 
read. If carrier fails nore that 50 tines during the read the noden uill be 
disconnected. 

PD' PENDING* START (2). (7:1) 

Indicates if there is a pending request. 

- No pending request. 

1 - Indicates that a pending operation needs to be started 

by the physical driver. This occurs only on noden ports 
uhen the physical driver uas in the niddle of processing 
a request and there uas a carrier fail. The current 
request can not be started until ctrritr detect is back 
on. Pending is then returned to the P&D flanager. Once 
carrier goes back on the Interrupt flanager uill start 
the pending operation. 

PO'nODEf1'SIGNALS(2).(8:8) 

Indicates the last knoun state of the noden input signals. A zero (0) indi- 
cates the eignal is on and a one (1) indicates the signal is unused or off. 

Bit - Unused. 

Bit 1 - Clear to send. 

Bit 2 - Signal quality. 

Bit 3 - Data set ready. 

Bit 4 - Call origin status. 

Bit 5 - Secondary carrier detect. 

Bit 6 - Ring indicator. 

Bit 7 - Carrier detect. 



UORO 3 

PO'CFTIRER 

Contains a carrier fail tiner index. This is a ?0-second tiner that is 
started by the Interrup*. Hanoler uhen a carrier fail occurs. If carrier 
detect does not cone been an aithin 30 seconds the noden is disconnected. 
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UORO 4 

PD'XONTIRER 

Contains an XOM tiner index. For tern types 21 and 22 (HP 2631 B processing) 
a 60-second tiner is started by the Interrupt Handler uhen the XOFF is 
received. If the XON is not received uithm the 60 seconds the "LDEV NOT 
READY" nessage is printed by the Initiation Hanager. 



PD'DSRTinER 

Contains a data set ready tiner index. If the port is to be speedsensed a 
2-nmute tiner is started by the Interrupt Handler uhen OSR goes on. A 
speedscnsc nust then be conpleted uithin the 2-nwutes. If the port is being 
FOPEN'ed then the tiner is started by the Initiation Hanager. DSR and OCO 
nust cone on and the noden connected uithin the 2-nmutes. 



UORO 6 

PD'DTRTIHER 

Contains a data teminal ready tiner index. This is a 5-second tiner started 
by the Initiation flanager uhen a noden is to be disconnected. OTR is driven 
lou for 5 seconds to disconnect the noden. 



PD'PORTSPEED 

Indicates the current line speed in charictert-per-second. 

UORO 8 

PD'PPROTOCOL 

Teminal DST relative pointer to the port protocol table. 

UORO 9 

P0'CHRRSIZE(9).(O:1) 

Indicates the size of the data character. 

- 7-bit characters uith a parity bit. 

1 - 8-bit character*. 
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2 - Data set ready sensing for FOPEN. This is the sane as 

state 1 except that the port uill be FOPEN'ed instead of 
speedsensed. 

3 • Data carrier detect sensing. The Interrupt Hanager is 

uaiting for DCD to cone on. DCD nust cone on uithin 
30 seconds after DSR is on otherwise the noden uill be 
disconnected. After OCO is on the port uill be speed- 
sensed and the noden state uill then be set to 5. 

4 - Data carrier detect sensing for FOPEN. This is the 

sane as state 3 except the port is being FOPEN'ed. 

5 - Speedsensing. The noden has been connected and a speed- 

sense has been started. 

6 - Connected. The noden is connected and the port has been 

successfully speedsensed if FOPEN'ed. If DCD goes off 
once the noden is connected it nust cone back on uithin 
30 seconds or the noden is disconnected. If DSR goes 
off the noden is disconnected. 

7 - Disconnecting. The noden is being disconnected. The 

driver uill drop DTR for 5 seconds. Then the noden 
state uill go back to 1 or 2. 



UORO 10 

PD'DPORTSPEED 

Indicates the configured lint speed in charactert-per-second. 



UORO 11 

PD'PPENTRYNUrlB(11).(0:8) 

Indicates the tern type nunber as specified in the I/O confi=»jr«uon. If a 
tern type file nane uas specified instead of a nunber or there uas an error 
in trying to use the file rum* this field uill default to 31. 

PD'TERnTYPE(11).(8:8) 

Indicates the current tern typ* mmb«r. If a tern type file nine is bting 
used this field uill be a 0. The current tern type nunber is tr,* one return- 
ed for FCONTROLs. 



UORO 12 

PD'HRRDURRE'TYPC 

R controller dependent uord. For ATP it contains the 'f suits of the 
self test. The contents of the uord are the sane as HU'SE-JUSl in the RTP 
physical driver DIT. For ADCC controller* the uord is unused. 
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PD'PRRITYENAB(9).(1:1) 

Indicates the state of parity checking. 

- Parity checking disabled. 

1 - Parity checking enabled. 

PD'UPRRITY(9).(2:2) 

Indicates the type of parity generation for urites. 

- Space, high order bit forced to zero. 

1 - Hark, high order bit forced to one. 

2 - Even parity. 

3 - Odd parity. 

PD'RPARITY(9).(4:2) 

Indicates the type of parity for read characters. Types *rt the sane as 

PD'UPRRITY. 

PD'ALL'PARITY(9).(1:5) 

A reference to the above 5-bit parity field. 

PD'ALTCHARSET(9).(6:3) 

Indicates the contents of the read alternate character set. 

0/2 - Unused. 

3 - Idle read set. 

4 - Transparent read set. 

5 - Vieu read set. 

6 - Binary read set. 

7 - Unused. 

PD'Cl£RRF(9).(9:1) 

Indicates if flow control uaits should be aborted before the next urite is 
started. Flou controls are aborted by the Initiation Hanager after break or 
subsysten break has been accepted by the nonitor. 

- Don't abort any flou controls. 

1 - Flou controls should be aborted. 

PD'H0DEn'STATE(9).(12:4) 

Indicates the current state of a noden. 

- Unused. 

1 - Data set ready sensing. The Interrupt Hanager is uaiting 

for DSR to cone on. After DSR is on the Interrupt Hanager 
uill uait for DCD to cone on. The noden state uill then be 
set to 3. 
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Protocol and Data Hanager Variable DIT Fornat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

,-.-| — | — |—| — |— I— I— |— |— I— I— I— I— I— 1-~ 
0| SYS D8 RELATIVE POINTER TO LOGICRL HONITOR DIT 



I- 
11 
| | LOPS TRIE 



-I — I — I — I — I- 



-I— I- 



-I — I— I- 



I- 



IREDIBRKI SSiSBFI SBUF1 |DSC| S8UF2 I DO I | 
|ECH|RED|BRK|RC I STATUS I DEV| STATUS |SRQ|UUC| OC 
., — |~|— |— I 1 — I 1 — l—l— 



21 HERD TBUF POINTER / SYS BUT 1 POINTER / BANK NUHBER 
I 



3 I TAIL TBUF POINTER / SYS BUF 2 POINTER / BUNK OFFSET 
I 



4 | HERD TBUF OFFSET / SYSBUF OFFSET / FROZEN DATA SE& OFFSET 
I- 



5 1 TAIL TBUF OFFSET / SYSBUF OFFSET 
|— 



6 I BTRNKED - NUHBER OF BYTES TANKED FOR URITE 



7 | RERDCNT • BYTE COUNT FOR READ 
I 

ioi 

I IOQ EOR CHARACTER 



I- 
111 ALTERNATE EOR 

| 

121 LAST EOR 

I — i — i — , — |— l—l— | 
13|NEU|NEU!C0N|BRK|CHR|FIL|SSB|C0N 



— | — | — | — 1-. 

BRKICRIIUAIIPCCI 
JTOPidNinODinOOiSETJINGJENAiENA ENA|URI|TBF|XQN| 



, — |—, — l — l — , — ,— I— 



NOIVEUIOUNIBINARV | 
LF|RED|RED|RERO I EOFCOOE 
-I 



-I — I— I- 
RLTERKATE SSBRERK 



— I — I — I — I- 



14| STRRT RFAD TIHE / COHPUTER RERO TME 100THS 



I- 



1SI STftr.T READ TIHE / READ TIHE OUT VALUE 



161 BRKTBUF - BROKEN RERD HERD TBUF POINTER 



I- 



17| e*KRCNT - BROKEN RERD COUNT 



I- 



201 SPOOLED DISC RDDR / DEVICE LINK FOR TBUFS 



I- 



21 1 SPOOLEC DISC RDDR / SAVED "UAIT- TBUF POINTER 



22 1 «™CnT - BYTES READ / TBUFS IN USE 
, 



8 
8 

9 

10 

11 

12 
13 
14 
115 
16 
17 
18 
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Protocol and Data Ranager V ariable PIT fornat (Cont.) 



-I 



231 OPERRTION ERROR - IHTERRUPT RRNRGER TO INITIATION RANAGER |19 

| ... | ... | ... | ... | — | — | — | — | — | 1 ... | — | ... | 

24 SUSICTL1SP0IESCIDC2IK0NILBLIBUCI | PEND 1 31 8 1 BIN | LOGI20 
LOP X SEN|PRR|REO|URT|nOO|nOO| I LOPSTRTE |RST|nOD|DEV| 

i=.| — I — i — I — i — i — i — i — i — i 1— i— i— i 

251 READ TYPE I LLDRC |PRT|REO LOCI LAST LDR OPCODE 1 21 
26 1 REQUESTED OEVICE STATUS J22 



27 | "OLD TRANSFER COUNT / STATUS URITE COUNT 
30 | POINTER TO SAVED EOF TBUF 



31 1 COUNT OF DflTR IN SAVED EOF TBUF 



I- 
32 1 RERD TIRER INDEX 



-I 

I23 
-I 

I24 
-! 

I25 
-I 

I26 



I- 



UORD 

PD'LDnDIT 

SYS DB rtletivt offttt to tht logical dtvice nonitor DIT. 

WORD 1 

NOTE: 

This uord it Hritt ehared betueen tht Initiation Ranager and Interrupt 
Ranagtr. When tht Initiation Ranager it nodifying thii uord tht interrupt 
tytttn thould bt off. 
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PD'N0'RERDECK0(1).(4:1) 

Indicates tht currtnt etatt of echo. 



ATP/RTP37/A0CC 



- Echo ie enabled. Echo nay bt enabled by an 100 function 

code of 8 (FCONTROL 12) by the Initiation llaneger 
or an "ESC tenicolon" f ron tht dtvice by the Interrupt 
Ranager. 

1 • Echo is dietbled. Echo nay be dittbled uith an 109 

function code of 9 (FCONTROL 13) by the Initiation 
Ranager or by an "ESC colon" f ron tht device by tht 
Interrupt Ranager. 

P0*BRERX(1).(5:1) 

Indicatee if break hat been detected. 

- Break hat not been detected. 

1 - Break ie enabled and hat been read. Thie io eet by 

the Interrupt Ranager uhen break ie detected and cleared 
by the Initiation Ranager when break hat been accepted or 
rejected. 

PD'SS8RERX(1).(6:1) 

Indicatee if eubeytten break net been detected. 

- Subeyeten break hae not been detected. 

1 - Subeyeten break is enabled and has been detected. Thie 

is eet by the Interrupt Ranager uhen the eubsysten break 
is read and cleared by tht Initiation Ranagtr uhen the 
subsyeten break ie accepted or rejected. 

PD , SBUFRERDC0RP(1).(7:1) 

Indicatee if softuare ie currently processing a reed bytt count exhausted in- 
terrupt for a epeoled read. 

- Read conplett interrupt ie not currently being 

processed for a spooled read. 

1 - Read conplete is currently being procttsed for • 

epooled read. 

PD'SBUFVSTflTOMS^) 

If the eurrent read ie using systen buffers thie field contains the status of 
one of the tuo eyeten buffers ueed for the read. 

- Enpty. Available for the read. 

1 - Filling. Currently being used for the read. 

2 - Full. The buffer ie full. 
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PD'LOPSTRTE(1).(0:4) 

Indicates the current logical operation state of a request. 



- No operation. The driver has finishsd a request and 

is uaiting for the next rtquest. 

1 - Reading. 

2 - Writing. 

3 - Status request to a device. Tht driver is currently 

unting a status request sequence to an HP 26316 printer. 

4 - Status read. The driver is currently reading etatue 

back fron an HP 2631 B. 

5 - Control-X response. The driver is currently uriting 

the "M!,cr,lf" after receiving the Control-X. 

6 - Waiting for a carriage return. The driver is currently 

uaiting for a carriage return to start or tenunate 
a block node read. 

7 - Write uith pending read. The driver is currently 

uriting and at the conpletion of the unte a read 
should be started. 

8 - Hardware setup uith pending read. The driver is 

currently eetting up the harduare and uhen done it should 
start the pending read. 

9 - Write uith pending status request. The driver is 

currently uriting and at the conpletion of the unte 
ehould request status fron the HP 2631 B printer. 

10- Speedsensing. 

11- Set port protocol. The driver ie currently setting up 
the currtnt port protocol. This uill include: 

- Enable/disable ENQ/ACK handshake 

- Enable/disable XON/XOFF handehake 

- ENQ/ACK handehake characters 

- ENQ/ACK bloek count 

- Delays for CR, LF, and FF 

12- Set epecial characters. The driver currently eetting 

up the read, the read alternate, the unte, and the urite 
edit special character eete. 

13- Roden control. The driver is setting up the noden 
logic and is uaiting for the noden signals to go to a 
knoun state. 

14- Freezing. The driver ie uaiting for the ueert etack to 
be frozen before etarting the currtnt read. Not 
currently used. 

15- Vieu read eet up. The driver ie uriting out the 
sequence to hone the cursor and lock the key board before 
etarting the current read. 



J*5«i*^ 
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PD'DISCNCT'DEVdJ.dO:!) 

Indicatee that the port ie being disconnected eo eone error conditione uill 
be ignored uhile thie ie taking place. 

- No dieconnect in progress. 

1 - Disconnect in progress. 

PD'SBUF2 , STAT(1).(11:2) 

If tht current read is using systen buffers this field contains tht etatue of 
the eecond of the tuo eyeten buffers ueed for the read. 

- Enpty. Available for tht rtad. 

1 - Filling. Currently being ueed for the reed. 

2 - Full. The buffer ie full. 

PD'OO'STATREQOJ.OSM) 

Indicatee if an HP 2631 B etatue request ehould bt done after all tht data 
tanked for tht uritt hae been uritten out. 

• Don't request printer status. 

1 • Rsqusst printer etatue at conpletion of the uritt. 

PD'UUCOMMrl) 

If ttt thtn tht uritt is a non-critical uritt and logical device nonitor ie 
auakened at the conpletion of the unte. The bit is sst by the Initiation 
Ranager and cleared by the Interrupt Ranager. 

PD'L0PC0RPLnE(1).(15:1) 

Indicatee if the current logical operation it conplete. 

- The logiral operation ie not conplete. 

1 - The logical operation ie conplete. Set by the Interrupt 

Ranager at the end of the operation, i.e., rtad it 
conplete. The logical nonitor is then auakened and 
notified the operation is conplete. 

UORD 2 

This uort contains an address for the current data transfer. There art thrtt 
tyoes of f»ta trar S f t r» uith the c-rrent type indicated in PD'RERO'LOC. The 
type cf transfer indicates the type of address. 

PD'HEflDTBL'F 

R TDS relative printer to the :.e*d TbUF. 



6.23.00 
25- 20 



' "\ 



RTP/RTP37/RDCC 



PO'SBUFI 

fl SYS OB relative pointer to a systen buffer. Sytten buffer* ere ueed for 
•pooled reeds uhere the transfers *rt done in disc sector sizes (128 uords). 
There are tuo systen buffers used, the second in PD'S8UF2, for the read. 
Uhen one becones full the second one is used uhile the Initiation nanager 
transfers the data fron the buffer to the disc. This suing buffer process is 
done until the read is complete. 

PD'BRKKNUnB 

Contains the bank nunber of the data segnent used for frozen reeds. 

UORD 3 

This uord contains *n address for the current data transfer. There *rt three 
types of data transfers uith the current type indicated in PD'RERD'LOC. The 
type of transfer indicates the type of address. 

PD'TRILTBUF 

P. TOS relative pointer to the tail TBUF. 

PD-S6UF2 

fl SYS DB relative pointer to a systen buffer. See PO'SBUFI for infornation 
on hou systen buffers are used. 

PD'BRNKOFFSET 

Contains the offset into a bank of the data eegnent ueed for frozen reads. 

UORD 4 

PD'HEROOFFSET 

Contains a byte offset into the head TBUF or systen buffer. For reads this 
is an offset to the first byte read. For urites this is an offset to the 
next byte to be uritten. 

PD'RBSOFFSET 

Contains *n offset into the frozen date segnent of uhere the spooled read 
data should be saved. 



UORO S 

PD'TRILOFFSET 

Containe a byte offset into the tail TBUF or systen buffer. For reads this 
offset is to the last byte read. For urites this is an offset to the last 
byte to be uritten. 
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UORO 6 

PD'BTRNKED 

This indicates the nunber of bytes that have been tanked into the TBUF for 
the unte. If -1, then all bytes have been tanked. The Initiation nanager 
uill tank up to a namnun of 5 TBUFs of unte data before the unte is start- 
ed. Rs each TBUF is enptied the Interrupt nanager uill restart the unte. 
Uhen there are 2 TBUFs left the Initiation nanager is notified and the tank- 
ing uill resune, uhile the last tuo TBUFs *rt being enptied. This continues 
until all the data has been tanked by the Initiation nanager, and all the 
data uritten out by the Interrupt Hanager. 

UORD 7 

PD'RERDCNT 

This indicates the nunber of bytes for the current or pending read. 

UORD 8 

PD'I0QE0R(8).(O:8) 

Contains the end-of-record character in the current read IOQ. 

P0*M0LF(8).(8:1) 

Indicates if a LF should be eent out at the end of the read. 

• Send a LF uhen the read is termnated by an EOR character. 

1 - Don't send a LF uhen the read is ternwated by an EOR 

character. 

PD'VIEURER0(8).(9:1) 

Indicates if the current read is a Vieu read. 

- The current read is not a Vieu read. 

1 - The current read is a Vieu read. Uhen a DC2 is 

received the Interrupt nanager uill unte out the 
sequence to hone the cursor and lock the key board. 

P0'0UNRERD(8).(1O:1) 

Indicates if special processing is done on 0C2s received during the read. 

- DC2 character* are processed "nornally", and uill start 

block node transfers. 

1 - DC2s don't start block node transfer* and uill be eaved 

as nornal read data. 
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PD'BINRRYRER0(8).(11:2) 

Indicates if the read is a binary read. 

- The read is not binary. 

1 - The read is a binary read. 

PD'E0F(8).(13:3) 

End-of-file code. Not currently used. 

PD'REROFLRGS 

R reference to all of the above fields. 

UORD 9 

PD'RLTEOR(9).(0:8) 

Contains the EOR character as specified in FCONTROL 41. 

PD'RLTSSBRERK(9).(8:8) 

Contains the alternate subsysten break character. The alternate subsystem 
break character is not deleted fron the read uhen detected. 

PD' TRANSPARENT 

R reference to both alternate characters. If non-zero then the read ie kncun 
as a transparent read. 

PD'ALTCHARS 

A reference to both alternate character*. 

UORD 10 

PO'LASTEOROOMOrS) 

This contains the last EOR character. Uhen EOR characters *rt to be changed 
by the Initiation nanager this field uill indicate if a physical change 
should be done, i.e., if the neu EOR and do FOR are me *a*e. 



NOTE: 

This is a urite only uord for the Iritiation Hanager. The Interrupt fmager 
should not urite to any (used or unuteo) fields as it n*y ci.se softuar* 
problene. 
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PD'NEUT0P(11).(O:1) 

Indicatee if the device ie at top of forn. 

- Device is not at top of forn. 

1 - Device is at top of forn. 

PD'NEULINE(11).(1:1) 

Indicatee if the device carriage ie at the beginning of a neu line. Note 
that this field ie currently unused. 

PD'C0NSn0DE(11).(2:1) 

Indicates if the device is currently in coneole node. 

- Oeviee is not in console node. Console node can be 

cleared uith an IOQ function code of 31 by the 
Initiation nanager. 

1 - Device is in console node. Console node can be set 

uith an IOQ function cede of 31 by the Initiation 
Nanager. 

PD'BRERKn00£(11).(3:1) 

Indicate* if the device is currently in brtaknode. 

- Device not in breaknodt. Cleared uith an IOQ function 

code of 30 by the Initiation nanager. 

1 - Device is in breaknode. Set uith an IOQ function code 

code of 30 by the Initiation nanager. 

P0 , CNARSET(11).(4:1) 

Indicates uhat read special character eet it currently being ueed. 

- Secondary. 

1 - Prinary. 

P0'FILUNG(11).(5:1) 

Indicatee if the Initiation Nanager is currently active and filling a unte 
TBUF. 

- Not filling. 

1 - Filling. This is cleared after the TBUF hae been filled 

and linked into the tail of urite TBUFe. 
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PD* SSBRKENRBC11 ). (6: 1 ) 

Indicates if subsysten break is enabled. 

- Subsysten break n disabled. Subtytttn break it 

disabled uith *n IOQ function codi of 12 (FCONTROL 16) 
by thf Initiation Ranager. 

1 - Subtytten brtak it enabled. Subtytttn break it enabled 

tilth an IOQ function code of 13 (FCOMTRDl 17) by the 
Initiation Ranager. 

P0'C0NSENAB(11).(7:1) 

Indicatet if the contole interrupt it enabled. 

- Contole interrupt it ditabled. Thit it ditabled uith 

an IOQ function code of 38 by the Initiation Ranager. 

1 - Contole interrupt it enabled. Thit it enabled uith an 

IOQ function code of 38 by the Initiation Ranager. 

PD'BRERKENRB(11).(8:1) 
Indicatet if break it enabled. 

- Break is ditabled. Break is disabled uith an IOQ function 

code of 10 (FCONTROL 14) by the Initiation Ranager. 

1 - Break is enabled. Break is enabled uith an IOQ function 

codt of 11 (FCONTROL 15) by the Initiation Ranager. 

PD'CRITICHLU(11).(9:1) 

Set by the Initiation Ranager if the write is a critical urite. fit the con- 
pletion of the urite the logical device nonitor is auakened and cleared by 
the Initiation Ranager. 

PD'URITFORTBUF(11).(10:1) 

Indicates if the driver is currently uaiting for a TBUf . 

- Not uaiting for a TBUF. 

1 - Driver is uaiting for a TBUF. This is set uhen the 

driver requests a TBUF and one is not available. See 
PD'DEVLINX for a eonplete explanation of uhen and hou 
the driver gets TBUFs that art not available. 

PO'PCC'XON'XOFFdD.dlM) 

Indicates if the hardware uill do the XON/XOFF handshake. 

- The PW driver uill handle the XON/XOFF handshake. 

1 - The hardwire uill handle the XON/XOFF handshake. 
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UORO 15 

PO'BROKRCNT 

Contains the byte read count of the broken read. 

UORO 16 

PC DEVLIN* 

Contains a TOS relative pointer to the neat device uaiting for a TBUF. The 
pointer is to the PU variable DIT. Uhen the driver can't get a TBUF it uill 
set PD'URITFORTBUF, indicating it is uaiting for a TBUF. In the TDS header 
(TDS'URITHERD'P and TDS'URITTRIL'P) there is a linked list of devices waiting 
for TBUFs. Again the list points to P&D variable DITs. The driver uill then 
link its variable DIT to the tail of the list. Rs TBUFs becone free, 
RETURNLYNXBUF uill give the TBUF to the device at the head of the list and 
then auaken the driver. The neu TBUF pointer is placed, by RETURNLYNXBUF in 
PD'TBUFURIT in the variable DIT. 

WORD 17 

PD'TBUFURIT 

Contains a TBUF given to the driver (by RETURNTBUF) that was uaiting for a 
TBUF. See PD'OEVUNK for a eonplete explanation of uhen and how the driver 
gets TBUFs that *rt not available. 

UORO 16 & UORO 17 

PD'DISCRDDR 

Contains a disc address for spooled reads. 

UORO 18 

PO'XFERCNT 

Contains the current count en the nunber of bytes re«d if currently reading. 
This count is only updated uhen the rtad it interrupted (i.t., TE-.-F tec ones 
full or read tpecial character) and it conplttt or has to bt restarted. 

PO' TBUFS' IN' USE 

R count on the nunber of urite TBUFs currently in u»«. E*ch tine the 
Initiation Ranager fills a TBUF this count is increnented. Rs the T ?- r s be- 
cone enpty the Interrupt Ranager will decre-eit this count, l-kn tre c&y.nt 
gets to 2 and there is still data to be tankto (PO'BTfiNKES <> -1) then the 
Initiation Ranager is auakened to rtsune tanking. 
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Contains the conputed read tine, in 1/100ths of a second of the last twed 
read. This is returned to the caller uith an FCONTROL 18. 



UORO 13 

PD'TIRINGRERD(13).(0:1) 

Indicates if the next read tine is to be calculated. 

- Don't conpute read tine for next read. Cleared uith an 

IOQ function code of 16 by the Initiation Ranager uhen 
the next read is started. 

1 - Conpute read tine for next read. Set uith an IOQ function 

code of 17 by the Initiation Ranager uhen the next 
read is started. The conputed read tine is placed in 
PD'RERDTIRE by the Interrupt Ranager. 

PD'RDTIREOUTVRLOSJ.OtlS) 

Contains a read tine out value in .1's of seconds if the next read is to be 
tined. This is set uith *n FCONTROL 5 by the Initiation Ranager uhen the 
next read is started. 

PD'PRERDTIRING 

R reference to the above read tining infornation. 

UORD 12 & UORD 13 

PD'RDSTRRTIRE 

For reads that are to return a conputed read tine this double uord uill con- 
tain the read start tine. This is initially set by the Initiation Ranager 
uhen the read is started. Uhen the read is eonplete the Interrupt Ranager 
places the conputed read tine in PD'RERDTIRE. 

UORO 14 

PD'BRKTBUF 

Contains a TOS relative pointer to the head TBUF of the broken read data. 
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UORD 19 

PD'ERROR 

Contains an error coded for the current transfer. This is a coroiunication 
uord used by the Interrupt Ranager to pats infornation to the Initiation 
Ranager. 

1 • No systen or teminal buffer available to restart the read. 

2 - Overrun error. 

3 - Franing error. 

4 - Unused. 

5 - Parity error. 

6 - Unused. 

7 - Roden error. 

8 - Unused. 

9 - Unused. 

10 - R type 2 EOR net been detected. 

UORO 20 

NOTE: 

Thie is a urite only uord for the Interrupt Ranager. The Initiation Ranager 
should not urite to any (used or unused) fields as it nay cause softuare 
problens. 

PD'SUSPLQPSTATE(21).(0:1) 

Set if a logical operation has been suspended that uill resune later. 

P0'CNTRLX(2O).(1:1) 

Indicates if the Centrol-X response should bt sent uhen a Control-X is 
received. 

- Don't send the Control-X response. The Control-X response 

is disabled uith an IOQ function code of 27 by the Initiation 
Ranager. 

1 - Control-X response is enabled. The Control-X response is 

enabled uith an IOQ function code of 26 by the Initiation 
Ranager. 

PD'SPDSENSE(20).(2:1) 

Indicates if the device has been speedsensed. 

- The device has not been speedsensed. 

1 • Set by the Interrupt Ranager after a successful 

spsedsense. 
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PD'ESCPRIR(20).(3:1) 

Indicates if tht driver is in the niddle of processing an ESC sequence to 
naybe enable or disable echo. 

- Not processing an ESC pair sequence. 

1 - Driver is currently processing an ESC pair. Set by the 

Interrupt flanager uhen an "ESC" special character is 
detected. fl one-byte read is then started to determine 
if echo should be changed. 

PD'DC2REfiD(20).(4:1) 

Indicates if a 0C2 uas read during the current read. 

- DC2 has not been read. 

1 - DC2 has been read. Set by the Interrupt flanager and 

indicates that the read is a Vieu read, blocknode or 
linebleck node read. 

PD'X0NURIT(2O).(5:1) 

Indicates if the driver has read a DC3 (XOFF) and is waiting for the DC1 
(XQN). Note that this is only used uhen the driver processes the XON/XQFF. 
The hardware nay actually do the XON/XOFF processing and the device nay be in 
an XOFF state and this bit n*y not be set. 

- XOFF has not been read. 

1 - XOFF has been read. 

P0'LBL0CXn0DE(2O).(6:1) 

Indicates if the current read is a line block node read. 

- The current read is not a line block node read. 

1 - fi DC2.CR has been read and the read is a line block 

node read. 

PD»BL0CKn0DE(2O).(7:1) 

Indicates if the current read is a block node read. 

- The current read is not a block node read. 

1 - R 0C2 has been read and the read is a block node read. 

PD'PEN0L0PSTRTE(2O).(9:4) 

This field contains the old logical operation. This is used uhen »n event 
occurs (i.e., noden interrupt) that results in a neu sequence or logical 
operations before the old one can be resuned. 
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PD'2631B'RESET(20).(13:1) 

Indicates if the HP 2631 B is initially being reset. This is used to prevent 
bad status reports betueen FOPEN's, etc., that nay occur uhen the printer is 
being reset. 

- HP 2631 B not being reset. 

1 - HP 26318 being reset. Don't report any transfer errors. 

PD'BINRRY'fl0DE(2O).(14:1) 
Indicates if in binary node. 

- Not in binary node. 

1 - Binary node enabled. 

PD'LOCONDEVtWJ.dSiD 

Indicates if the device is a logon/speedsense device. 

- The device is not a logon device. 

1 • The device is a logon/speedsense device. 



NOTE: 

This is a urite only uord for the Initiation flanager. The Interrupt flanager 
should not urite to any (used or unused) fields as it nay cause software 
problens. 

PD'RERDTYPE(21).(0:4) 

This indicates the type of read that is currently active. This is set by the 
Initiation flanager and not changed until the read is logically conplete. 
Different read types are: 

- No operation. 

1 - Character node/block node read. 

2 - Spooled read. 

3 - Idle read. 

4 - Transparent character/block node read. 

5 - Vieu/3000 read. 

6 - Binary read. 

7 - Not used. 



0.23.00 
25- 30 



RTP/RTP37/R0CC 



PD , LLDnC(21).(4:3) 

Contains the last logical device nonitor call to tht Initiation flanager. 

- Unused. 

1 - Set device characteristics (Ifl'SET'DEV). 

2 - Read (IfTREfiD). 

3 - Urite (WURITE). 

4 - Rbort call (Ih" ABORT). 

5 - Refuse call (IfTREFUSE). 

6 - Device control call (in* DEV* CONTROL). 

7 - Unused. 

PD'PRINTER(21).(7:1) 

Set if logical device is a printer. 

PD'RERDU)C(21).(8:2) 

Indicates uhere the data is going for tht current read. 

- Unused. 

1 - TBUFs are being used for current read. 

2 - Systen buffers are being used for current read. 

3 - Read data is going to a frozen data segnent. 

PD'LDH0PC0DE(21).(1O:6) 

Contains the opcode of the last call by the nonitor to tht Initiation 
flanager. PD' LLDflC uill indicate the last Initiation flanager call. 

Opcodes for calls to Ifl'SET'DEV: 

- Partial conpletion. Initiation flanagtr should 

continue uith old operation. 

1 - Return device characteristics. 

2 - Set a neu tern type. 

3 - Change parity. 

4 - Change the echo flag. 

5 - Change transparent read special characters. 

6 - Enable/disable subsysten break. 

7 - Enable/disable break. 

8 - Enable/disable Control-R. 

9 - Set/clear console node. 

10- Set/dear console node. 

11- Set data length. 

12- Disconnect. 

13- Enable/sisable Control-X reply. 

14- Har.^up tineout. 
:5- Self test. 

6 - Uait for current operation to conplete. 

7 - Flush broke" read TBUFs. 

8 - Disconnect immediately. 
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Opcodes for calls to Ifl'RERD: 

- Continue current operation. 

1 - TBUF read. 

2 - Frozen stack read. Not used. 

3 - Spooled read. 

4 - Speedsense request. 

5 - Read tineout. 

6 - Neu read request. 

7 - Start pending read. 

8 - Break accepted. 

9 - Subsysten break accepted. 

Opcodes for calls to Ifl' URITE: 

- Continue current operation. 

1 - Tank data. 

2 - Tank token. 

3 - Start urite. 

4 - HP 2631 B status request check. 

Opcodes for calls to Ifl' RBORT: 

- Unused. 

1 - Halt all I/O. 

2 - Rbort current operation and start idle read. 

3 - Hard preenpt. 

4 - Soft preenpt. 

5 - Break accepted. 

6 - Subsysten oreak accepted. 



Opcodes for calls to Ifl' REFUSE: 

- Unused. 

1 • Break refused. 

2 - Subsysten break refused. 



UORO 22 
PD' STATUS 



Contains the status byte returr»d fron an HP 2631 B printer. 

Bit 4 - If set then a transfer error occurred. 
Bit 5 - If set then the device i* offline. 
Bit 6 - If set then the device buffer is full. 
Bit 7 - If set then the device xu out of paper. 
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UORO 23 

PD'OLDXFERCNT 

Indicates tht nunber of bytes read up to tht last back tpact. Needed to the 
successive LF '• art not output on devices that required a LF in rtsponst to a 

BS. Stt and cltared by tht Interrupt nanagtr. 

PD' STATUS' UCNT 

Contain* the write count for a HP 2631 B atatut request. 

UORO 24 

PD'EOFTBUF 

Contains a TDS relative pointer to the saved EOF TBUF(s). 

UORO 25 

PO'EOFCMT 

Contains a byte count of saved EOF data in PD'EOFTBUF. 

UORO 26 

PD'RERDTinERINDEX 

fl tiner index for reads that are to be tintd. 



0.23.00 
25- 33 



RTP/ATP37/R0CC 



UOROS 0/11 

Contains a file nant of the ttrntypt file. 

UORO 12 
PP'VFC 
Teminal OST relative pointer to a VFC entry in tht VFC table. 

UORO 13 

PP' ECHO. (0:1) 

Indicates the initial state of echo. 

- Echo is disabled. 

1 - Echo is enabled. 

PP'EHORCK.dil) 

Indicates if the device dees EHS/RCK handshaking. 

- ENO/RCK handshaking is disabled. 

1 - ENQ/RCK handshaking is enaoled. PP'EHQCHRR and 

PP'RCKCHRR will contain the ENQ/RCK character and 
PP'ENOBLOX will contain the block size. 

PP'DELRY.(2:1) 

Indicates if delays should be enabled. 

- Delays are not enabled. 

1 - Delays are enabled. PP'DELCYCR, PP'DELRYIF and 

PP'OELRYFF uill contain the delay anount in 10tht of 
seconds. 

PP'XFL0U.(4:1) 

Indicates if XON/XOFF handshaking should be enabled. 

- XON/XOFF handshaking is disabled. 

1 - X0N/X2FF handshaking is enabled. 

PP'XSTRIP.(5:1) 

Indicates if the Xuh/XOFF should be stripped. 

- The XOk/XOFF should not be stripped fron read data. 

1 - The MH/ v irF Mill be stripped fron rtad data if 

handshakes *rt di«-bled. 
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PP'EI1STRIP.(6:1) 

Indicates if Control-Y should bt ttripptd. 

- Control-Y should not bt stripped fron rtad data. 

1 - Control-Y uill bt stripped fron read data. 

PP» CONS' STRIP. (7:1) 

Indicatts if Control-A should bt ttripptd. 

- Control-A should not bt ttripptd fron rtad data. 

1 • Control-A uill bt ttripptd fron rtad data. 

PP'FFQK.(12:1) 

Indicatts if FF should bt alloutd m output. 

- Tht FF should bt replaced by PP'FF'NEUCHAR. 

1 - Tht FF art valid. 

PP'Da'CWTMMU:!) 

Indicates if a DC3 should be appended to uritt data afttr tach CF, LF. 

- Don't append any DC3s to uritt data. 

1 • Append a DCS following tht CF, LF. 

PP'BLOCKnODE.(14:2) 

Indicates tht typt of blocknodt rtad to do on DC2s. 



1 - Lint blocknodt. 

2 - Pagt blocknodt. 

3 • Either lint or pagt blocknodt. 



PP'DO'XOH'TMER.tOrl) 

Indicates if tht drivtr should start »n XOh tintr after an XOFF ie received. 

- Don't start an XON tiner if an XOFF is recti v»d. 

1 - Start an XON tiner, indicated by PP'XON'UHE 

if an XOFF is received. 

PP'URITESTRTUS.(1:1) 

Indicates if a status request, "ESCTDCI", should be uritten to the device. 

• Don't request status fron the device. 

1 - Send a ttatut rtqutst to tht device. 
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PP'2631B'FIX.(2:1) 

Indicates if status should be requested fron the device after an XOFF even 
though PP'URITESTRTUS nay be tct. 

- Don't uorry about uhen the statue request is sent. 

1 - Don't rtquest status as the XOFF uas received in the 

niddle of a line and ue don't uant to possibly send 
an ESC sequence in the niddle of a user ESC sequence. 

PP'IMIT'DEV.(3:1) 

Indicates if an initialization sequence should be sent to the device. 

- There is no initialization sequence. 

1 - There is *r\ initialization sequence. 

PP'VFC'0K.(4:1) 

Indicates if there is a VFC file for the device. 

- There is no VFC file to send to the device. 

1 - There is a VFC file for the device. 

PP' CHAR 'SIZE. (5:3) 

Indicatet the size of the data characters. The value is 1 less than the ac- 
tual character size, i.e.. 8-bit data uill be indicated by a 7. 

PP'FF'NEUCHRR.(8:8) 

Contains the replacenent character for FFs if FFs are to be replaced. 



UORD 15 

PP'WU1E'VRUD.(0:1) 

Indicates if the tern type file nane is the current tem type. 

- The current tern type is specified by a nunbered 

tern type. PD'TERHTYPE uill contain a nunber and the 
file being used uill be TER?r'nunber*.PU8.SYS. 

1 - The current tem type is specified by a file nane. 

PO'TERflTYPE uill contain a 0. 

PP'DELRYCR.(1:5) 

Indicates the anount of tine in 10ths of seconds to delay on CR. 

PP'DELAYLf.(6:5) 

Indicates the mount of tine in 10ths of seconds to delay on LFs. 
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UOROS 20/29 

Contains the block node cursor string. 

UORD 35 

PP'U)ST'SSBRK.(0:8) 

Contains the last subeysten break character detected. 

PP'PRRITY'ENRB.(12:1) 

Indicates if parity checking should be enabled uhen the device is FOPEM'ed. 

- Parity checking is disabled. 

1 - Parity checking is enabled. 

PP'F0PErPRRITY.(13:3) 

Indicates uhat the parity should be uhen the device is FOPEN'ed. 

- Space. 

1 - Bark. 

2 - Even. 

3 - Odd. 

UORD 36 

PP'0DD , EKR8.(4:1) 

Indicates if parity checking thould be enabled if odd parity is sensed. 

- Parity checking is disabled. 

1 - Parity checking is enabled. 

PP'ODD'PRRITY.tS^) 

Indicates uhet the parity should be if odd (0) parity is sensed. 

- Space. 

1 - Hark. 

2 - Even. 

3 - Odd. 

PP'EVEN'ENRB.(12:1) 

Indicates if parity checking should be enabled if even parity is sensed. 

- Parity checking is disabled. 

1 - Parity checking is enabled. 
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PP'DELAYFF.(11:5) 

Indicates the anount of tine in 10ths of seconds to delay on FFs. 

UORD 16 

PP'ENQBL0K.(O:8) 

Indicates the nunber of characters to send before doing the ENQ/RCK 
handshake. 

PP'ENQCHAR.(8:8) 

Contains the inquire character, nornally the ENQ. 

UORD 17 

PP'N0RCKRCTI0N.(5:3) 

Indicates uhat to do if the RCK is not received on an ENQ/RCK handshake. 

1 - Resune unte uith no ENQ. 

2 - Resune unte uith ENQ. 

PP'RCKCHRR.(8:8) 

Contains the acknouledge character, nornally the RCK. 

UORD 18 

PP'BL0CK'TRIG.(O:8) 

Contains the blocknode read trigger character, nornally a DC1. 

PP'TRIOGER'CHRR.tSrS) 

Contains the read trigger character, nornally a DC1. 

UORD 19 

PP'BSRESP.(13:3) 

Indicates the response for the back space character. 

1 - Nothing. 

2 - Send end of nediun. 

3 - Send a "LF". 

4 - Send a "/". 

5 - Erase the character. 
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PP' EVEN* PARITY. (13:3) 

Indicates uhat the parity should be if even (1) parity is sensed. 

- Space. 

1 - Hark. 

2 - Even. 

3 - Odd. 

UORD 37 

PP'X0N'TinE.(8:8) 

Contains the anount of tine in seconds to uait for the XON after w XOFF. 

UORDS 42/73 

Contains a special character function code for each of the 128 ASCII charac- 
ters. This is an *rr*y of 128 4-bit entries. There is one entry for each 
character, going sequentially fron to 127. The special character function 
codes are as folious: 

- No special function. 

1 - Console attention (i.e., Control-fl). 

2 - Cancel one character (i.e., backspace). 

3 - Horizontal tab. 

4 - Linefeed. 

5 - Type 1 end-of-record (i.e., CR). 

6 - Type 2 end-of-record (i.e., an IOQ EOR character). 

7 - XON 

8 - Block node alert character (i.e., DC2). 

9 - XOFF 

10- Rewrite input buffer. 

11- Cancel line (i.e., Control-X. 

12- Subeytten break (i.e., Control-Y). 

13- Strip and ignore. 

14- Escape character. 
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Hardware PIT fornat 



RTP/BTP37 Harduare PIT fornat 



1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 

| — | — I — I— I — I— I — I — I — I — I — I — I — I — i— i — ; 
0| SYSPB RELATIVE POINTER TO LOGICAL DEVICE RONITOR PIT 
I 



1 | TERniNRL OST RELATIVE POINTER TO PROTOCOL & DATA PIT 

I 



2| TERHINRL OST RELATIVE POINTER TO CONTROL PROGRAR AREA 
| 1— | — | 1 

ICONTROLinOOlNONI UAIT | 
31 TYPE I CON | 551 REASON I TRUE KARDUARE UNIT NURBER 



I- 



-I— I — I — I — I- 



-I- 



-I- 



IPRIIECOIIPLISPDISETI I I 

4|CKR|ENR|URT|SPC|URK| | LAST HU STATE I I HRROUARE STATE 

, — | — |— | — | — | — | — I — I — I — I — I — I 

5iSPP|PRF| |E02|BR0|TTY| FF|XON|UID|PRR GEN I CK| UNE SPEED 

,...,— 1 — | — | — | — |.-| — 1 — | 1 — I 

61 NEXT TO LAST INTERRUPT RERSON | LAST INTERRUPT REASON 



I- 



-|- 



7| RERP COUNT 

10|"*|R/L| RERO BANK 

111 RERO RDPRESS 
, ... | ... , 

12|"*|R/L| URITE BANK 
|— | — | 

131 URITE ADDRESS 



I- 



14| URITE COUNT 

151 OLD DIRECT CHOI I DIRECT CORRRNO! I OLD URIT 

161 FRRItlNG ERROR COUNT I LAST SPECIAL CHARACTER 

17|P/F| PCC DRTE COPE |P/F| nCC DRTE COOE |P/F| RSC DATE COOE IJPT 15 
| ... | 1 — | — | ... | — | 1 — | 1 -. 

201 NEXT STATE I I PS I I ROPER OUTPUT CONTROL 16 
| 1 1— |— | 

21 j RODEn INPUT REFERENCE j ROPER INPUT CONTROL 17 

18 
25 



I 1- 

22 1 

31 1 PRIRRRY SPECIRL CHARACTER RRSK (8 UQRPS) 



I- 
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RTP/RTP37 Harduare PIT Fornat fCont.) 



32 1 



35 1 SECONPRRY SPECIRL CKARRCTER SET (4 UORPS) 
| 

36 1 

41 | URITE SPECIAL CHARACTER SET (4 UORPS) 

| 

42 1 

45 1 URITE EPIT SPECIAL CHRRRCTER SET (4 UORPS) 



I — 
46 1 URITE BUFFER 

I 

47| 

56 1 RERP BUFFER (8 UOROS) 
| — | — | 

S7IPIRIPINI 



, — , — |- 



1 

1 26 
129 
1 

130 
133 
1 

134 
137 
1 

138 
1 

139 
146 
- 1 1 

I PIRGNOSTIC INTERRUPT COPE |47 



/*f^!v 



601 

611 SAVED CLOCK VALUE - (2 UOROS) 



-I- 



I- 



-|- 



-I- 



-I- 



148 
149 
-I 



621 BLOCK COUNT | CR BELAY | ENQ CHARACTER I LF DELAY 150 
, , 1 1 1 

631 ACK CHARACTER | FF DELAY | I 151 

, , 1 | 1 



UORO 

HU'LDITP 

SYSPB relative pointer to the logical n cm tor PIT. 

UORP 1 

HU'PPITP 

Terninal DST rtlativt pointer to tht protocol and data nanagenent DIT. 

UORD 2 

HU'CP'P 

Terninal DST relative pointer to tht control progran area. Control progran 
area it 32 bytee. 
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UORD 3 

KU'C0NTR0LLER(3).(O:?) 

Indicattt the type of controller. 

- Unuttd. 

1 - RTP controlltr. 

2 - RDCC controlltr. 

3 - Unuttd. 

HU , R00ERPRNEL(3).(2:1) 

Indicattt the type of connection/ junction panel. 

- Direct connection, device tubtypt uat configurtd at or 14. 

1 - Rodtn connection, device tubtype uat configured at 1 or 15. 

KU'N0N55(3).(3:1) 
Indicattt tht typt of CPU. 

- Stritt 64 typt CPU. 

1 - Stritt 40/44 typt CPU. 

HU , URIT , RERS0N(3).(4:4) 

Thit indicattt hou tht ntxt inttrrupt should bt proceeeed. R uait rtaton it 
ttt up uhtn tht drivtr it about to halt tht PCC and uill uant to ttltctivtly 
process the next interrupt. Uait reasons art at follows: 

- No uait reason. Process the interrupt as per tht inttrrupt 

typt. 

1 - Abort ponding. Tht phytical drivtr it trying to halt tht 

PCC. Rodtn inttrruptt »rt proceeeed othtruitt all othtr 
inttrruptt satisfy tht halt. 

2 - Rtstt PIT. Tht port it being reset. Uhtn tht next 

interrupt occurs the rettt uill bt conpltttd. 

3 - Pisconntct. The PCC is being halted so that a control 

progran can be startsd to disconnect the noden. Rny 
interrupt uill satisfy the halt. 

4 - RCC sstup. Tht RCC is being stt up and tht drivtr it 

uaiting for tht "end of control progran" interrupt 
indicating the RCC has been set up. Rny interrupt except 
noden errors uill satisfy the setup conplsts. 

5 - Romtor noden signals. The driver has set up the RCC and 

is uaiting for an interrupt indicating that a noden line 
is in the correct state, i.e.. PSR on. 

6 - E02 reset. The PCC is hung and the driver is in the 

process of resetting the PCC before it does the next read or 
urite. 
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7 - Dunp port. The PCC ie dunping its RRR. 

8 • Speed-spscified. The herduare is uaiting for the "end 

of control progran" interrupt indicating that the harduare 
hae been set up accordingly as a speed-specified port. 

KU'UNIT'NUR(3).(8:8) 

Indicates the true unit nunbcr of the device. Unit nunbere uill range fron 
to 127. 



UORD 4 

HU'PRISPCL(4).(0:1) 

Indicates what read special character set is being used. 

• Secondary read special character sst enabled. 

1 - Prinary read special character set enabled. 

KU'ECK0(4).(1:1) 

Indicates tht current statt of tcho. 

- Echo it disabltd. 

1 • Echo it tnabltd. 

NU'I0LE , URT(4).(2:1) 

Indicattt if tht current perfom I/O uill urite out one or tuo trigger 
characters before the read begint. 

- No triggtr characters are to be se^t. 

1 - One or tuo trigger characters are to bs written. 

HU'SP0S(4).(3:1) 

Indicstes whether the port is a speed-specified port. 

- The port is speedsens:ng. 

1 - The port is speed-specified. 

HU , RCC , SETUP , UAK(4).(4:1) 

Indicates whether ue uait for eno CP after setting up noden signals. 

- Uait for end CP. 

1 - Do not uait for end CP. 
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HU'LSTST«TE(4).(6:4) 

Thit indicattt tht latt ttatt of tht PCC. Uhtn an inttrrupt occur* tht cur- 
rtnt ttatt in HU'STATE it tavtd in HU'OLD'STRTE. Thtn HU'STRTE it set to 
"input tavt". 

HU'STRTE(4).(12:4) 

Thit indicattt tht currtnt ttatt of tht PCC. Stt uhtn a PCC control progran 
ii ttarttd or afttr an inttrrupt occur*. Pottiblt ttattt art at follows: 



1 


- Rtading. 


2 


- Unting. 


3 


- Spttdttnaing. 


4 


- Unused. 


5 


- Stt port protocol. 


6 


- Stt tptclal characttrt. 


7 


- Stlftttt. 


8 


- Dunping PCC. 


9 


- Port it froztn. 


10 


- Reading nodtn inputt. 


11 


- Rtttt. 


12 


- Idle read. 


13 


• Setting up noden tignalt. 


14 


- Romtoring nodtn tignalt 


15 


- Input tavt. 



UOROS 

HU'SET'PROTOCOUSMO:!) 

Indicattt if tht PCC hat done a ttt port protocol. 

- Tht PCC hat not dont a ttt port protocol. No I/O 

theuld bt dont until afttr a ttt port protocol. 

1 - Tht PCC hat dont a ttt port protocol. Tht currtnt 

protocol it indicattd in bitt 11/15 of thit uord. 

HU'P0UERFHIU5).(1:1) 

Indicattt if a poutr fail hat occurred and it being procttttd. 

- No poutr fail hat occurred. 

1 - Power fail hat occurred. 

HirRE$ET'DIT(5).(2:1) 

Indicattt if tht hardware DIT it bting reset. 

- DIT it not bting rtttt. 

1 - DIT it bting rtttt. 
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KU'XQN'EMRB(5).(7:1) 

Indicate* if tht PCC uill do tht XON/XQFF handthakt. 

- Tht PCC uill not do tht XON/XOFF handthakt. 

1 - Tht PCC uill do tht XON/XOFF handthakt. 

KlT8»Birn0DE(5).(8:1) 

Indicattt tht tizt of tht data characttr. 

- Oata uill bt transmtted at 7-bit uith a parity bit. 

1 - Oata uill bt trantnitted at 8-bit data. 

HU»PRRITY»6€N(5).(9:2) 

Indicattt th* typt of parity generation. Thit fitld it only valid for 7-bit 
data. 

- Output ditabltd and tht 8th bit it forced to 0. 

1 - Output disabled and tht 8th bit it forced to 1. 

2 - Output parity generation it tnabltd and it uill bt tvtn. 

3 - Output parity gtneration it tnabltd and it uill bt odd. 

HU'PRRITY'CHtTKtSMlIrl) 

Indicattt if input parity checking it tnabltd. 

- Input parity chtcking it ditabltd. 

1 - Input parity chtcking it tnabltd. 

HIT UHE'SPEED(5). (12:4) 

Indicattt tht current trantftr ratt of tht PCC. 

- 110 baud. 

1 - 300 baud. 

2 - 600 baud. 
3-1200 baud. 

4 - 2400 baud. 

5 - 4800 baud. 

6 • 19200 baud. 
7-9600 baud. 

8 - 76800 baud - unsupported. 

9-9600 baud. 
10-1200 baud. 
11 - 300 baud. 
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HIT CLEAR' E02(5). (3:1) 

Indicattt if tht dnvtr it in tht procttt of rttttting tht PCC to cltar up 
the problen of the PCC getting hung because location EO of itt RRn ntvtr it 
cleared. 

- The driver it not trying to fw a hung PCC. 

1 - Tht drivtr it in tht niddlt of trying to fret a hung PCC. 

KU'BR0KEN(5).(4:1) 

Indicattt if tht port it broktn. 

- The port it not broktn. 

1 - The port is broken and uill not operate until reset. 

HIT DELAY' ENAB(5). (5:1) 

Indicatts if TTY delays arc tnabltd. 

- TTV delays *rt disabltd. 

1 - TTY delayt art enabled. There uill be a delay 

following the tranenittien of each "CR", M LF", or "FT". 

HU'FF'ENRB(5).(6:1) 

Indicates if forn feeds are enabled. 

- Forn feeds are disabled. Each forn feed character uill 

be replaced uith a "LF". 

1 - Forn feeds are enabled. Each "FF" character it untttn 

out and not rtplactd uith a "LF". 
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UORD 6 

HIT LAST' INTERRUPTS). (0:8) 

Containe the old interrupt code. Uhen an interrupt occur* tht inttrrupt codt 
in HIT INTERRUPT 'CODE it novtd here and tht ntu interrupt it plactd in 
HIT INTERRUPT' CODE. 

KU'INTERRUPT , C0DE(6).(8:8) 

Containt tht latt inttrrupt codt. Sont of tht inttrrupt codtt have different 
neanings depending on the PCC version. Thott difftrent code* are nottd. 
Inttrrupt codtt 20/28 are only for patt 3 PCCt. 

- Invalid. 

1 - Rtdundant ttart I/O. 

2 - End control progran. 

3 - Illegal control progran. 

4 - Uritt tpteial characttr. 

5 - Ten-second RCK tintout. 

6 - Read conplett. 

7 - Parity trror. 

8 - Rtad tpteial characttr. 

9 - Patt 2 PCCt - break detected. Patt 3 PCCt - franing trror. 

10 - Ovtrrun trror. 

11 - Patt 2 PCCt - characttr read and not in read ttatt. 

patt 3 PCCt - not uted. 

12 - Spttdttntt conplttt. 

13 - Patt 2 PCCt - nodtn trror. Patt 3 PCCt - break dtttettd. 

14 • Uritt conplttt. 

15 - Stlftttt conplttt. 

16 - Edit tpteial characttr. 

17 - Diagnoatic failure. 

18 - Control progran halted. 

19 - Dunp conplttt. 

20 - Nodtn data ovtrrun. 

21 - Rodtn RIB hardware error. 

22 - noden invalid PCC read. 

23 - Nodtn PCC ntttagt trror. 

24 - noden link error. 

25 - noden debounce error. 

26 - noden non-natkablt interrupt trror. 

27 - NC6801 trror. 

28 - Unknown nodtn trror. 



UORD 7 

HU'RERD'CNT 

Currtnt PCC read bytt count. 
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UORO 8 

Nott that thit uord is used in full for tht ATP Dflfi registers. It thould not 
bt changed in its fornat. 

hu'rd'right'left(8).(i:i) 

Indicate* to tht PCC uhat bytt to start tht trantftr to. 

- Lift. 

1 - Right. 

HU'RERD'BRNX 

Indicates tht bank nunber for tht current read. 



HU'READ'ADDR 

Contains tht absolutt start address of the read. 

UOROS 8/9 

HU'RERD'RBS'RDDR 

Contains a double uord absolute start address for the read. 

UORD 10 

Note that this uord is used in full for the RTP DJ1A registers. It should not 
be changed in its fomat. 

HU'UT'RIGHT'LEFT(10).(1:1) 

Indicates to the PCC uhat byte to start the urite f rem 

- left. 

1 - Right. 

KU' URITE* BRKX 

Indieatee the bank nunber for the current urite. 

UORO 11 

KU'URITE'ROOft 

Contains the absolute start address of the urite. 
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UOROS 10/11 

HU' URITE 'RBS'RDDR 

Contains a doublt uord absolute start 

UORO 12 

HU* URITE' CMT 

Current PCC urite byte count. 

UORD 13 

HU'OUTDIRECrcrWUMO*) 

Contains tht old direct connand. Uhtn a ntu direct connand is issued 
HIT DIRECT 'COnnflND is saved here. Then tht ntu direct connand is saved in 
HU' DIRECT' COnnRND. Possible direct connands are: 

1 - noden freeze. 

2 - PCC freeze. 

4 - Start I/O. 

8 - Halt direct connand. 

HU'DIRECT'C0nnRND(13).(6:4) 

Contains tht last direct connand issued. Uhen a neu connand is issued the 
old connand is saved in HU' OLD' DIRECT' CnD. 

HU'0LD'URIT'REAS0N(13).(13:3) 

Contains the old uait reason. HU'URIT' REASON is saved here before a neu uait 
reason is set up. 

UORD 14 

HU'FRRMNG'ERR0R(14).(0:8) 

Contains a running count on the nunber of franing errors that occur. Used 
only for gathering infornation uhen dunps are read. 

HU'SPEC'CHRR(14).(8:8) 



^ 



Contains tht last sptcial character dtttcttd. 
cial characttr is dtttcttd. 
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UORD 15 

HU'SELFTEST 

Contains the results f ran the PCC/RSC selfteet. 

HU'PCC'PF(15).(0:1) 

Indicates the results of the PCC selfteet. 

- Selfteet passed. 

1 - Sclftest failed. 

«TPCC'DATE(15).(1:4) 

Contains the current PCC date code. 

- Pass 1 PCC. 

1 - Pass 2 PCC. 

2 - Pass 3 PCC. 

3 - Pass 4 PCC. 

HU'riCC'PF(15).(5:1) 

Indieatee the results of the (ICC stlfttst. 

- Sclftest passed. 

1 - Sclftest failed. 

HU»htC'DATE(15).(6:4) 

Contains the current ncC date code. 

• Pass 1 NCC. 

1 - Pass 2 NCC. 

2 - Pass 3 hXC. 

HU'nSC'PF(15).(10:1) 

Indicates the results of the HSC self test. 

- Sclftest passed. 

1 - Sclftest failed. 

HU'nSC'DATE(15).(11:4) 

Contains the current HSC date code. 

- Pass 1 ItSC. 

1 - Pass 2 HSC. 

2 - Pass 3 I1SC. 
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HU'JUNCTI0N'TYPE(15).(15:1) 
Indicates the type of junction panel. 

UORD 16 

HU'NEXT'STRTEOeMO^) 

Indicates tht next state of the PCC. See KU' PENDING' START for en explanation 
of hou this field is used. 

HU' PENDING* STRRT(16). (6:0 

Indicates if there ie a pending start. This occurs uhen the driver ie active 
and a noden signal changes preventing the next read or urite fron starting. 
Everything ie saved in the DIT and uhen the noden line is correct (i.e., DCD 
is on) the read or urite uill be started. 

- No pending start. 

1 - A pending read or urite is ready. 

HU'n0DEn'0UTPUT(16).(8:8) 



If a bit ie eet then that eig- 



Contains an 8-bit noden output control nesk. 
nal uill be "on" or plus 12 volte. 

Bit - Frequency select. 
Bit 1 - High order binary digit. 
Bit 2 - Second order binary digit. 
Bit 3 - Lou order binary digit. 
Bit 4 - Secondary request to send. 
Bit 5 - Call request. 
Bit 6 - Request to sent. 
Bit 7 - Data teminal ready. 



UORD 17 

HU'nODEn'REF(17).(0:8) 

Contains an 8-bit noden reference nask. There ie one bit for each input sig- 
nal. If the signal is different fron the reference and ie a needed signal as 
specified by the control naek then an interrupt uill occur. 

Bit - Unused. 

Bit 1 - Clear to send. 

Bit 2 - Signal quality. 

Bit 3 - Data set ready. 

Bit 4 - Call origin status. 

Bit 5 - Secondary carritr detect. 

Bit 6 - Ring indicator. 

Bit 7 - Carrier detect. 
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HU'llODEn'CTL(17).(8:8) 

Contains an 8-bit noden control nask. Thtrt is one bit for each input sig- 
nal. If the bit it set then the signal Mill be used, otherwise it is ig- 
nored. The nask is the sane as in HU'nODEfTREF. 



UORDS IS/25 

HU'PRI'SCHRS 

Contains an 128-bit nask of the prinary special character set. There is 
1-bit for each of the 128 RSCII character*. If set then the character is a 
special character. The bit nap has to be looked at as a 16-byte nap uhere 
the characters »rt nunbered 0-7, right to left. For exanple if Control-fl is 
a special character the first uord of the table uould be Z1000. If f 
uas set the first uord uould be 1. 



UOROS 26/29 
HU'SEC'SCHRS 
Contains an 8-character buffer for a secondary special character set. 

UOROS 30/33 
HU'URI'SCHRS 
Contains an 8-character buffer for urite special characters. 

UOROS 34/37 

HU'EOIT'SCHRS 

Contains an 8-character buffer for urite edit special character set. 

UORD 38 

MT URITE' BUFR 

Contains a 2-character urite buffer used to tend trigger character* for 
reads. 

UOROS 39/46 

HIT READ 'BUFFER 

Contains a 16-character read buffer used by the PCC for idle reads. 
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RDCC Harduare PIT Fomat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|— 1...|— |— I— I— I— I— I— I— I— l—l— I— I— I— 
0| SYS06 RELATIVE POINTER TO LOGICAL DEVICE HONITOR DIT 

1 | TERMNHL DST RELATIVE POINTER TO PROTOCOL & DATA DIT 

21 SYS08 RELATIVE POINTER TO CHANNEL PR0GRRJ1 AREA 

|CONTROL|nOD|NON| I NINE BIT DRT NUT18ER 
3 1 TYPE I CON | 5S| I WB • I CHANNEL i I DEVICE ■ 

|— |— |~|~|— I — I— | |...j j— | 

|PRI|XON|SET| III II 

4|CHR|X0F|URK| | | | LAST HU STATE I I HRROUARE STATE 

|...| — 1_..|...|...| — j — | — | — l — l — |— | 

5|SPP|PRF|BRK| IBROITTYI FF|XON|UID|PAR G£N| CK| UNE SPEED 



|...|...|--|...| — | — 1~.| — | — |- 
61 NEXT TO LAST INTERRUPT REASON | LAST INTERRUPT REASON 

| CPVA N| INTERRUPT CODE I CPVA «| INTERRUPT CODE 

, , 1 1 

7| READ COUNT 

I — | — | 

10|**«|R/L| READ BANK 

| ... | ... | 

11| RERD ADDRESS 

|--|~| 

12|***|R/L| URITE BANK 

, ... | ... | 

131 URITE PDDRESS 

| 

14| URTTE COUNT 

I 

151 LAST CHRR TO NEED DELAYS 

, 

16| FRAMED ERROR COUNT 



Vint, needed after delay 
-I- 



I— • 



17| SPEEOSENSE STARTED TlflER REQUEST 

I I ! 



| LAST SPECIAL CHARACTER 
-I- 



| rtODEfl INPUT CONTROL 



-I- 



201 NEXT STATE I 

I I 

21 | PODEh INPUT KEFCRfcNCE 

I 

22 1 

31| PhMARY SPECIAL CHORPCTER tlASK (t UOROS) 

I 

321 

351 SECONDARY SPECIAL CHARACTER SET (4 UORDS) 

| 



| I1ASK FOR ALL (lODEA SIGNALS OFF 



12 



14 

15 

16 

17 

118 
I25 
-I 
1 26 
I29 
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UORO 47 

HU' DIAGNOSTICS). (0:1) 

Indicates if the diagnostics trt running. 

- The diagnostics are not running. 

1 - The diagnostics *rt running and all interrupts uill be 

processed by the diagnostics. 

HU'DIAG'INTERRUPT(47).(1:1) 

Indicates if an interrupt occurred that has to be processed by the 

diagnostics. 

- No interrupt has occurred. 

1 - An interrupt has occurred and the interrupt reason is 

in HU'DIAG' REASON. 

HU'DIAG'REAS0N(47).(8:8) 

Contains the current diagnostic interrupt code. The current interrupt code 
is saved here uhen an interrupt occurs and the diagnostic bit is set. The 
interrupt codes are the sane as specified in HU' INTERRUPT 'CODE. 

UORO 48/49 

HU'llODEfTTinE 

Contains the current clock value uhen a noden control progran is started. 
Uhen the driver is to halt the PCC and this uord is non-zero then the halt 
uill not occur until 200 nsec have passed. This is to prevent a noden over- 
run error. 

UORO 50 

HU'PP1(50).(0:8) 

Contains either the ENQ/ACK block count or the CR delay. 

HU'PP1(50).(8:8) 

Contains either the ENQ character or the LF delay, depending on uhether ue 
use ENQ/ACK handshake or tine delay for flou control. 

UORD 51 

HU'PP2(51).(0:8) 

Contains either the ACK character or the FF delay. 
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ADCC Harduare DIT Fomat (Cont.) 



36 

41 



42 1 
45| 



46 



47 1 
56 



URITE SPECIAL CHARACTER SET (4 UORDS) 



URITE EDIT SPECIAL CHARACTER SET (4 UOROS) 



URITE BUFFER 

READ BUFFER (8 UOROS) 



-I— I- 



-I 
I30 
1 33 

-I 
I34 

1 37 
-I 

1 38 
-I 

I39 
I46 



57 DIAIDINI 
— l — l 



I DIAGNOSTIC INTERRUPT CODE |47 
, 1 

SPEED USED UHEN PORT IS SUBTYPE 4 OR 5 |48 



TRACE UORO FOR COUNTING INTERRUPTS 



-I- 



-I 



ENABLE XI1IT NOT FULL tlASK | DISABLE XMT NOT FULL HASK 150 
1 1 

631 CURRENT ECHO, HODEH SIGNALS I ECHO OFF, HODEH SIGNALS 1 51 



64 | INPUT SAVE CHARACTER REAO 
| 

65 1 SET UP UART PARAI1ETERS 

|. H — |...| — | — I — I— • 
661 0E| PEI FE|BRK|non| NA| 



-I 



| INPUT SAVE STATUS READ j 52 
., 1 

| INPUT SAVE nOCEfl SIGNALS READ 153 
.| 1 — I — I 

|XQN|PCK|54 



|.-.|...|...| — I — I — I 1 — ~| — |-.-j 



67| ENQUIRY BLOCK COUNT 

I- 
701 ENQUIRY CHARACTER/ LF PAD 



j CHARS LEFT TO ENQ/ CR PRO I 55 
I I 

I ACKNOULEDGE CHAR/ FF PRO 156 



I I 1 



71 1 ACKNOULEDGE UNIT TWER REQUEST 

, 

721 
1111 HRROUARE SPECIAL CHARACTER BIT HAP (16 UORDS) 

1121 

1211 INPUT SAVE BUFFER (8 UORDS) 



I- 



157 

-I 
158 
173 

-I 
174 
181 

-I 



122j I82 

141 1 BUFFER SPACE USED TO CHANGE SPECIAL CHARACTER RODS (16 UOROS) 1 97 

, 1 
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UORDO 

HU'LDITP 

SYSDB rtlativt pointtr to thi logical nenitor OIT. 

UQRO 1 

HU'PDITP 

Ttrninal DST rtlativt pointtr to thi protocol and data nanagtntnt OIT. 

UORD 2 
HU'CP'P 
SYSOB rtlativt pointtr to tht channtl progran arta. 

UORD 3 

KU'C0NTR0Ll£R(3).(O:2) 

Indicattt tht typt of controlltr. 

- Unuttd. 

1 - ATP controlltr. 

2 - RDCC controlltr. 

3 - Unuttd. 

HU»n00EflPfiHEL(3).(2:1) 

Indicattt tht typt of connection/ junction pantl. 

- Oirtct conntction, dtvict tubtypt uat configured at or 14. 

1 - flodtn conntction, dtvict tubtypt uat configurtd at 1 or 15. 

KU'N0M55(3).(3:1) 
Indicattt tht typt of CPU. 

- Stritt 64 typt CPU. 

1 - Stritt 40/44 typt CPU. 

HU'DRT(3).(7:9) 

Containt tht 9-bit DRT nunbtr of tht dtvict. Thit contittt of a 2-bit MB 
nunbtr, 4-bit channtl nunbtr, and 3-bit dtvict nunbtr. 
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UORD 5 

HU'SET'PR0T0C0L(5).(O:1) 

Indicattt if tht ROCC hat dont a ttt port protocol. 

- fl ttt port protocol hat not bttn dent. 

1 - R ttt port protocol hat bttn dont. Tht current 

protocol it indicattd in bitt 11/15 of thit uord. 

HU'P0UERFRIl(5).(1:1) 

Indicattt if a poutr fail hat occurred and it being procttttd. 

- No poutr fail hat occurred. 

1 - Poutr fail hat occurred. 

HU , BRERK'0ETECTE0(5).(2:1) 

Indicattt that a BRERK condition hat bttn dtttcttd. 

- Ho BRERK condition dtttcttd. 

1 • R BRERK condition it currently bting procttttd. 

HU'BR0KEN(5).(4:1) 

Indicatet if tht port is broktn. 

- The port it not broktn. 

1 - Tht port i6 broktn and uill not optratt until rtttt. 

HU'DELAY'EWSMStl) 

Indicattt if TTV dtlayt art tnabltd. 

• TTY dtlayt art disabltd. 

1 - TTY dtlayt are tnabltd. Thtre uill bt a dtlay 

follouing tht trantnittion of tach H CR", "IF", or "FF". 

HU'FF'ENRBtSMSM) 

Indicattt if font feedt art tnabltd. 

- Fo^i ftedt art disabled. Each fsm fttd character uill 

bt rec laced witn a "IF". 

1 - Fom feed! are enabled. Each "FF" character it uritttn 

out and not replaced uith a "IF". 

HU*X0N'ENRB(5).(7:1) 

Indicattt if tht drivtr uill do tht XON/XOFF handthakt. 

- Tht driver uill not do the XON/XOFF handshake. 

1 - The drivtr uill do tht XON/XOFF handthakt. 
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UORD 4 

HU'PRISPC 1.(4). (0:1) 

Indicattt uhat read tptcial characttr ttt it bting uttd. 

- Secondary read tptcial characttr ttt tnabltd. 

1 - Prinary read tptcial characttr ttt tnabltd. 

HU , 00 , XON'X0FF(4).(1:1) 

Thit bit indicattt if XON/XOFF handthaking it tnabltd. 

HU'SETUP , URKE(4).(2:1) 

Indicattt uhtthtr ut uait for tnd CP afttr tttting up noden tignalt. 

- Uait for tnd CP. 

1 - Do not uait for tnd CP. 

HU'0LD'STflTE(4).(6:4) 

Thit indicattt the latt ttatt of tht RDCC. Uhtn ttt interrupt occurs tht cur- 
rent ttatt in HU'STRTE is tavtd in HU' OLD' STATE, if tht ttatt it not "input 
tavt". Thtn HU'STRTE it ttt to "input tavt". 

HU'STRTE(4).(12:4) 

Thit indicattt the current ttatt of the RDCC. Set uhtn an RDCC channtl 
progran it ttarttd or afttr an inttrrupt occurt. Pottiblt ttattt are at 

follout: 

1 • Reading. 

2 - Uriting. 

3 - Spttdttnting. 

4 - Generating an inttrrupt fron an input tavt tvtnt. 

5 - Stt port protocol. 

6 - Stt tptcial character*. 

7 - Unuttd. 

8 - Unuttd. 

9 - Unuttd. 

10 - Unuttd. 

11 - Outputting triggtr character*. 

12 - Idle read. 

13 - Setting up nodtn tignalt. 

14 - Monitoring nodtn tignalt. 

15 - Input tavt. 
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HU'8'BIT'nODE(5).(8:1) 

Indicates the tilt of tht data characttr. 

- Data uill be trantnitttd at 7-bit uith a parity bit. 

1 - Data uill be trantnitted at 8-bit data. 

HU'PRRITY'G£N(5).(9:2) 



Thit fitld it only valid for 7-bit 



Indicattt the type of parity generation. 
data. 

- Output parity generation it tnabltd and it uill bt tvtn. 

1 - Output parity generation it tnabltd and it uill bt odd. 

2 - Output parity gtntration it tnabltd and it uill bt even. 

3 • Output parity gtntration it tnabltd and it uill bt odd. 

KU'PRRITY'CH£CK(5).(11:1) 

Indicates if input parity checking it enabled. 

- Input parity checking it ditabled. 

1 - Input parity checking it tnabltd. 

KU'UKE ( SPEED(5).(12:4) 

Indicattt the current transfer rate of the RDCC. 

- External - unuttd. 

1 • External - unuttd. 

2 - 50 baud - unused. 

3 - 75 baud - unused. 

4 - 134.5 baud - unuttd. 

5 - 200 baud - unused. 
f - 600 baud. 

7 - 2400 baud. 
8-9600 baud. 
9-4800 baud. 

10 - 1800 baud - unuttd. 

11 - 1200 baud. 

12 - 2400 baud. 

13 - 300 baud. 

14 • 150 baud. 

15 - 110 baud. 
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UORO 6 

HU'0LD'INTERRUPT(6).(0:8) 

Contains tht old interrupt code. Uhen jn interrupt occur* the interrupt code 
in HU' INTERRUPT * CODE it noved here and the neu interrupt it placed in 
HU'INTERRUPT'CODE. The firtt tuo bitt thou the CPVR nunber and the renainmg 
bitt are tht interrupt code. 

HU'MTERRUPT'CQDE(6).(8:8) 

Centaint tht latt interrupt cede. Tht firtt tuo bitt are tht CPVR nunbtr, 
and tht latt tin bits art tht inttrrupt code. 

CPVR - Belated HIOP interrupt and channel progran abortt. 

CPVR 1 - Speedatnting interrupts and RCK uait interrupts. 

- Unuted. 

1 - 9600 baud or first part of 4800 baud. 

2 - Firtt part of 2400 baud. 

3 - Firtt part of 1200 baud. 

4 - Firtt part of 600, 300, or 110 baud. 

5 - Second part of 600 or 300 baud. 

6 - Stcond part of 110 baud. 

7 - Latt part of all but 9600 baud. 

8 - Non-tpeedsente detected by channel progran. 

9 - ftoden lines nay have changed. 

10 - Special character received during RCK uait. 

CPVR 2 - Input Save ttatc inttrruptt/Error conditions 

- Unuted. 

1 - Input tavt bufftr full. 

2 - Error condition during input tave. 

3 - Special character during input tavt. 

4 - Error condition (overrun, parity, franing, 

brtak, nedtn changt). 

CPVR 3 - Standard channel progran interrupts. 

- Unuted. 

1 - Unuted. 

2 - End of ttt port protocol. 

3 - Unuted. 

4 - Special chartcter during urite. 

5 * Unuttd. 
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6 - Read conplete. 

7 - Parity trror dtttcttd. 

8 - Special character during read. 

9 - Franing error detected. 

10 - Overrun error detected. 

11 - Unuted. 

12 - Unuttd. 

13 - Break detected. 

14 - Urite conplete. 

15 - Unuttd. 

16 - Edit tptcial characttr found. 

17 - Unuted. 

18 - Unuttd. 

19 - Unuted. 

20 - Unuttd. 

21 - Unuted. 

22 - Unuted. 

23 - Unuted. 

24 - Unused. 

25 - Unuted. 

26 - Unuted. 

27 - Unused. 

28 - Unuttd. 
Hodtn lint change detected. 
Need to intert pad characters. 
Special character during uait. 



29 
30 
31 
32 

33 - Rn EMQ character has been untten. 

34 - Rn RCK character hat been uritten. 

35 - End of noden control channel progran. 



Trigger characters uritten. 
■ Rn EhT 



UORD 7 

HU'RERD'CNT 

Current read byte count. 

UORO 8 

HU'RD'RI6HT'L£FT(8).(1:1) 

Indicates uhat bytt to ttart the tranaftr t 

- Left. 

1 - Right. 
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HU'RERD'BRRK 

Indicates the bank nunbtr for tht current read. 

UORD 9 

HU'RERD'RODR 

Containe tht absolute ttart address of tht read. 

UORD 10 

HU»UT'RI6HT'l£FT(10).(1:1) 

Indicattt what bytt to ttart tht uritt f ron. 

- Left. 

1 - Right. 

HU' URITE 'BRKK 

Indicattt tht bank nunbtr for the current uritt. 

UORO 11 

HU' URITE' flOOR 

Contains tht absolute ttart tddrttt of tht uritt. 

UORD 12 

HU' URITE' CRT 

Current uritt bytt count. 

UORO 13 
HU'DELRY'CHRR(13)(0:8) 

Containt tht latt characttr (tithtr output data or a triggtr characttr) that 
requiret dtlay syncs afttr it. 

HU'0ELRY»INT(13).(8:8) 

Containt tht inttrrupt cod* to generate afttr tht dtlay tynct havt been 
generated. 
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UORD 14 

HU'FRRf1IK6'ERR0R(14).(0:8) 

Containt a running count on tht nunbtr of franing errors that occur. Used 
only for gathtring information uhtn dunpt are read. 

KU'SPEC'CKRR(14).(8:8) 



Updattd each tine a neu tpt- 



Containt the last special character detected, 
cial character is detected. 



UORD 15 

KU'SENSE'TIRER 

Uhen the firtt inttrrupt during a speedsense occurs (the first part of tht 
bit patttrn hat bttn received), a one-tecond tiner it started to abort tht 
ttntt if not conpltttd during that tint. Thit uord it uttd to ttore tht 
tintr requtst index. 

UORD 16 

HU' NEXT' STRTE06). (0:4) 

Indicatts the next state of the RDCC. 

rUrnflSK'0rF(16).(8:8) 

This uord contains the bit pattern necessary to nask off all nodsn signals. 
This is used uhenever a noden change is detected in order to cancel the chan- 
nel strvice request until the next request to changt tht noden output 
signals. 

UORD 17 

HU'nuDEn'REF(17).(0:8) 

Contain* an 8-bit rrden reference nark. There is one bit for each input sig- 
nal. If ti-e signal is different fron the reference and is a needed signal as 
specified by the control nask then an interrupt uill occur. 
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Bit 


- Unused. 






Bit 1 


• Unu?eo. 






eit 2 


. « re f »r*nce (1 * 


iatk). 




Bit 3 


- Clear tc send. 






Bit 4 


- Data set ready. 






B:t 5 


- Ring indicator. 






Fit 6 


• Daia carrier detect 






-it 7 


- Secondary data carrier detect. 
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WPH0DHrCTl(17).(8:8) 

Contains an 8-bit noden control nask. There it ont bit for tach input sig- 
nal. If tht bit is set thin signal uill bt ustd, othtruist it is ignortd. 
Tht nask is ths sans as in HU'flOOEII'REF. 



UOROS 18/25 

HU'PRI'SCHRS 

Contains an 128-bit nask of ths prinary opteial character stt. Thtrt is 
1-bit for tach of tht 128 ASCII characttrt. If ttt thtn tht characttr is a 
sptcial characttr. Tht bit nap hat to bt looktd at at a 16-bytt nap uhtrt 
tht characttrt art nunbtred 0-7, ltft to right. For txanplt if Control-A is 
a spscial characttr tht firtt word of tht tablt uould bt 1100000. If 
backtpact uts stt tht firtt uord uould bt 1200. 

WORDS 26/29 
HU'SEC'SCHRS 
Contains an 8-characttr buffer for a ttcondary sptcial characttr ttt. 

UORDS 30/33 
HU'URI'SCHRS 
Containt an 8-eharacttr bufftr for uritt tptcial charaettrt. 

UOROS 34/37 

HIT EDIT' SCHRS 

Contains an 8-characttr bufftr for uritt tdit tptcial characttr ttt. 

UORD 38 

HU'URITE'BUFR 

Containt a 2-characttr uritt bufftr ustd to ttnd triggtr characttrt for 
rtadt. 

UORDS 39/46 

HU' READ 'BUFFER 

Containt a 16-characttr rtad bufftr ustd by tht RDCC for idit rtadt. 
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HU*nODEIT0UT2(51).(12:4) 

This fitld contains ths idtntical information as HU'ITODEITQUTI. Uhtn tht tn- 
tirt bytt (8:8) is output to tht RDCC, tht nodtn lintt art ttt and tcho it 
turntd off. Thit it ustd uhtn tranaftrring to tht input tavt ttatt fron a 
rtad. 



UORD 52 

HU' SAVE* RERD(52). (0:8) 

This fitld containt tht characttr rtad uhtntvtr an trror ttatut it dtttettd. 

This is nttdtd to distinguish a brtak fron an ordinary franing trror. 

HU'STATUS , FE(52).(12:1) 

This contains tht franing tmr ttatut bit rtad fron tht UART. It indicattt 
tithtr a franing trror or brtak. 

HU'STATUS'0E(52).(13:1) 

This containt tht ovtrrun trror ttatut bit rtad fron tht UART. 

HU'SlnTUS , PE(52).(14:1) 

This contains tht parity trror ttatut bit rtad fron tht UAtT. 

UORD 53 

HU'UART(53).(0:8) 

This fitld contains all ths UART control infomation including charactsr 
uidth, parity, and stop bit infomation. It alto hat tht bit ttt uhieh 
causts a nastsr cltar to bt ptrfomtd on tht UART. 

HU'SRVE'nODEn(53).(S:8) 

This fi»ld contains tht status of tht nodtn lintt bting nonitortd. Only bitt 
3 through 7 of tht bytt art uttd and thty havt tht tant fornat at 
HW'nOCEn'REF abovt. 

UORD 54 

«U'lK$flVE'OE(54).(0:1) 

Th*s bit is stt trut uhtn an ovtrrun trror uat dtttettd during input tavt, 
and ciearsd uhtn ths condition hat bttn tarvictd. 

HU , IKS«VE'PE(54).(1:1) 

This bit is ustd as abovt for tht parity trror condition. 
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UORD 47 

Not currently ustd. 

UORD 48 

HU' SPEC 'SPEED (48) 

If tht port is configured as subtyps 4 or 5, this uord contains tht tp 
CPS) at uhich us uill initially stt up tht UART. This is ths sans 
configured spttd. 

UORD 49 

This uord is currently uttd for ptrfornanct ntasurentntt. 

UORD 50 

HU»ENRBl£*XMT(50).(0:8) 

This field contains the bit pattern necessary to enable the transnitter buff- 
er not full channel ttrvict requtst. 

Hu'DISABl£'XniT(50).(8:8) 

This field contains tht bit patttm necessary to disable the trantnitttr 
bufftr not full channtl ttrvict request. 

UORD 51 

HU'ECH0(51).(3:1) 

This bit indicattt tht current ttatt of tcho during rtadt. 

- Echo it off. 

1 - Echo it on. 

HU'f10DErr0UT1(51).(4:4) 

Thit fitld containt tht current tttting of tht nodtn output lintt. Uhtn tht 
tntire bytt (0:8) it output to tht RDCC, tcho and nodtn lintt are ttt. Tht 
bitt are uttd at follout: 

Bit 4 - Rtquttt to ttnd. 
Bit 5 - Data ttrninal ready. 
Bit 6 - Spttd ttltct. 

Bit 7 - Secondary rtquttt to ttnd. 
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HU'INSAVTFE(54).(2:1) 

Thit bit it uttd at abovt for the franing error condition. 

HU'INSAVE'BRERK(54).(3:1) 

Thit bit it uttd at abovt for tht break condition. 

Rli'INSAVE'nODEn(54).(4:1) 

Thit bit it uttd at abovt for a nodtn lint changt. 

HU'INSAVE'N0ACK(54).(5:1) 

Thit bit it uttd at above for an ACK tineout. 

HU'X0N'URIT(54).(14:1) 

Thit bit indicattt that an XOFF uat rectivtd and tht drivtr it uaiting for an 
XON to continut. 

HU'ACK'UAIT(54).(15:1) 

Thit bit indicattt that an ENQ uat ttnt and the driver is uaiting for v\ ACK 
to continut. 

UORD 55 

HU'EMQ'8L0CK(55).(O:8) 

This fitld contains the block count of characters used in the ENQ/ACX hand- 
shake. If the value is aero, the handshake is not used. 

HU'ENQ'C0UNT(55).(S.8) 

If EHO/ACK it tnabitd, this fitld contains tht nwbtr of characttrt ltft to 
uritt before another ENQ should bt gentratcd. 

HU'CR'DElAYtSSMB^) 

If ENQ/RCK is disabled, this field contains the nunfcer of .1 seconds to delay 
after CR characters. 

UORD 56 

HU'ENq'CHBR(56).(0:?) 

If ENQ/ACK is enabled, this field contains ths enquiry ch.racttr. 
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HU'LF*DELRY(S6).(0:8) 

If ENQ/RCK it disabled, this fitld contains the nunber of .1 seconds to delay 
after LF characters. 

HU'RCK'CHRR(56).(8:8) 

If ENQ/RCK it enabled, this fitld contains the Rcknoultdge character. 

HirFF'DEUW56).(8:8) 

If ENQ/RCK it ditabled, thit field containt the nunber of .1 tecondt to delay 
after FF characters. 

UORD 57 

HH'ENQ'TinERtS?) 

Uhen an Enquiry character hat been uritten to the terninal, a ten-second 
tiner it started. Thit word contains the tiner request index for that tiner. 

UORD 58/73 

HU'CHRR'flRP 

These sixteen uords contain a bit nap uhich reflects the 256-bit nap special 
character *rr*y in the hardware. 

UORD 74/81 

HU'INSRVE'BUF 

These sixteen bytes arc used as the input save buffer. 

UORD 82/97 
HU'CHRR' BUFFER 



These thirty words %rt used as buffer space 
»rr*y in hardware mist be changed. 



whenever the special character 



Hessaoe Table Fornat 

The nessage table is not used but contains the following: 
"cr.lf.bell.bellVLDEV t1 ROT RERDY Vcf.lf" 
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RTP/RTP37 Port Error Rrea Fornat (Cont.) 

, 1 

413] i 

426 I IDT - Z7 UOROS WJD LDTX (OR ZEROS IF NONE) - Z5 UORDS I 
, 1 

427] ] 

4531 ICO PCB (OF ZEROS IF MOKE) - Z25 UORDS _ I 

454] ] 

5001 LDT PCB (OR ZEROS IF NOME) - Z25 UOROS I 

501] i 

700| PCC RERORY (OR ZEROS IF NONE) - Z200 UORDS I 

, 

701] ] 

7201 RTP/RTP37 REGISTERS (OR ZEROS IF NONE) - Z20 UOROS I 
, 

721] ] 

11201 USERS STRCK - Z200 UORDS I 

| 

1121] i 

11441 ILT - Z16 UORDS RND ILTX - Z6 UORDS I 

| 

1145] 1 

11501 VFC SIR'S - Z4 UORDS ! 

, 

1151] ] 

11521 VFC INFORKRTION BLOCK - Z2 UORDS j 

| j 

I VFC ENTRY (OR NOTHING IF NONE) - Z20 UOROS I 

, -j 

I VFC BUFFER (OR NOTHING IF NONE) - Z10S UOROS I 

i I 

I IOQ RND TBUF INFORhRTION BLOCK - Z3 UORDS I 

j , 

| 100/ S - Z14 UORDS ERCH RND TBUF'S/SBUF'S - Z105/Z2O0 UORDS I 
| 1 
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Port Error firta Fomat 

RTP/RTP37 Port Error Rrea Fornat 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

0| NUnBER OF CALLS TO LYNX'ERROR 
, 

11 

431 TERMNRL DfiTfl SEGflENT HERDER - Z43 UOROS 

| 

44] 

701 HONITOR DIT - Z25 UORDS 

| 

71 1. 

10SI PROTOCOL RND DRTR URNRGER FIXED DIT - Z1S UORDS 

| 

106] 

221| PORT PROTOCOL DIT - Z114 UORDS 

| 

222] 

254 1 PROTOCOL RND DRTR I1RNRGER VRRIRBLE DIT - Z33 UORDS 

| 

255] 

3401 RTP/RTP37 HRRDURRE DIT - Z64 UORDS 

| 

341] 

352 | TBUF TABLE - Z12 UOROS 

| 

353] 

372 | RTP/RTP37 CONTROL PROGRRH - Z20 UOROS 

| 

373] 

376 | LPDT - Z4 UORDS 

j 

377] 

406 | DLT - Z10 UORDS 

, 

407] 

4121 DRT - Z4 UORDS 

, 
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The VFC info mat ion block contains the following: 

Uord 0.(0:1) - 0: No VFC entry or data dunped. 
1: R VFC entry was dunped. 
.(8:4) - Nunber of initialization buffers dunped. 
.(12:4) • Nunber of data buffers dunped. 

Uord 2 • TDS relative pointer to IOO/TBUF infornation block. 

The IOQ/TBUF infornation block contains the following: 

Uord • Nunber of lOQs dunped. 

Uord 1 - TDS relative pointer first TBUF dunped. 

Uord 2.(0:2) - 0: No TBUFs or SBUFs were dunped. 
1: TBUFs were dunped. 
2: SBUFs were dunped. 
.(2:14) • Nunber of TBUFs or SBUFs dunped. 
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ROCC Port Error Rrta Fornat 

1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 



,...|. H — 1~ I — I— I — I — I — I— I — I — I — I — I — I- 



0| NURBER OF CRLLS TO LYNX 'ERROR 
I- 



1] 

43 | TERRINRL DRTfl SEGflENT HERDER - X43 UORDS 
, 

44] 

70 | nONITOR DIT - Z25 UORDS 

, 

711 



1051 PROTOCOL RND DRTR IMAGER FIXED OIT - 215 UORDS 
, 

106] 

2211 PORT PROTOCOL OIT - 2114 UORDS 

| 

222] 

254| PROTOCOL RMD DRTR RRNRGER VARIABLE DIT - 233 UORDS 

255] 

4161 RDCC KRRDURRE DIT - 2142 UORDS 

| 

417| 



4301 T6UF TABLE - 212 UORDS 
| 

4311 



7461 CHANNEL PROGRRH - 2316 UORDS 



I- 
747] 

752 1 LPDT - 24 UORDS 



753] 

762 1 DLT - 210 UORDS 
| 

763] 

766 1 DRT - 24 uordt 



I- 
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RDCC Port Error Rrta Fornat f Cont. ) 



, 

767] 

10021 LOT - 27 UORDS RND LDTX (OR ZEROS IF NONE) - 25 UORDS 
| 

1003] 

1027| 100 PCS (OF ZEROS IF NONE) - 225 UOROS 

| 

1030] 

10541 LOT PCB (OR ZEROS IF NONE) - 225 UORDS 

| 

1055] 

12541 USERS STACK - 2200 UORDS 

, 

1255] 

13001 ILT - 216 UORDS RNO ILTX - 26 UORDS 

| 

1301] 

1304 | VFC SIR'S - 24 UORDS 

| 

1305] 

13061 VFC INFORHRTION BLOCK - 22 UORDS 



] 

| VFC ENTRY (OR NOTHING IF NONE) - 220 UORDS 

| 

] 

I VFC BUFFER (OR NOTHING IF NONE) - 2105 UORDS 

]""" "" " 

I IOQ RNO T8UF INFORRRTION BLOCK - 23 UORDS 

| 

] 

| IOQ'S - 214 UORDS ERCH RND TBUF'S/SBUF'S - 2105/2200 UORDS 
| 
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Tht VFC infornation block contains tht following: 



Uord 0.(0:1) - 0: No VFC entry or data < 
1: R VFC entry uat dunpad. 
.(8:4) - Nunbar of initialization bufftrs dunptd. 
.(12:4) - Nunbar of data buff art dunptd. 

Uord 2 - TDS ralativa pointar to IGQ/TBUF infornation block. 

Tha IOQ/TBUF infornation block containa the following: 

Uord - Nunbar of IOOe dunptd. 

Uord 1 • TDS ralativa pointer firat TBUF dunptd. 

Uord 2.(0:2) - 0: No TBUFa or SBUFa utra dunptd. 
1: TBUFa uere dunptd. 
2: SBUFa «ere dunpad. 
.(2:14) - Nunbar of TBUFa or SBUFa dunpad. 

WF TfWt Fprnjt 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
— I — I — I — I — I — I — I — I — I — I — I — I — I — I — I — 
■4Un8ER OF TBUF'S IN TDS 

TBUr SSRVEDFORREROS " I SIZE OF TBUF IN UORDS 

TDS RELATIVE POINTER TO HERD OF FREE TBUF LIST 



3 TDS RELATIVE POINTER TO TRIL OF FREE TBUF LIST 



ItflXinui) NURBER Of TBUF'S EVER IN USE 



CURRENT NURBER OF TBUF'S IN USE 



6 

7 | TOTRL NURBER OF TBUF REQUESTS 
| 

101 NUHBER OF TBUF REQUESTS DENIED 



I- 

11| UNUSED 
| 
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UORDO 

IBUF'NUIVURD 

Contains tht nunbtr of TBUFa in tha data tegnent. 

UORD 1 

TBUF'RERD'SRVE(1).(0:8) 

Containa tha nunbar of TBUFa aavad for reads. 

TBUF'BUFSIZE(1).(8:8) 

Indicatta tht tizt in uordt of tach TBUF. 

UORD 2 

TBUF'USTHERD'P 

Containa a TDS ralativa pointar to tha head TBUF in tha TBUF 
frtt litt. 

UORO 3 

TBUF'LISTTAIL'P 

Containt a TDS relative pointer to the tail TBUF in the TBUF 
frtt litt. 

UORD 4 

tbuf'hrxused 

Indicataa tht naxinun nunbar of TBUFS in use at any tint. 

UORD 5 

TBL'F'INUSE'URD 

Indicatta tht nunbtr of TBUFt currtntly in uae. 

UORDS 6/7 

TOTRLPEQUESTS 

Indicatts *ht total nunbtr of TBUF requetta. 
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UORO 8 

TBUF' DENIED' URD 

Indicate* the nunber of TBUF requests that utre dtmtd btcauet 
there utrt no frtt TBUFS. 



Mot currently uttd. 

TBUF Fomat 



01 TOS TABLE RELATIVE POINTER TO NEXT TBUF - IF NO LINK 
, 

1] 
1031 USER DATA 



I- 

104| - NEVER USED 
I 
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UORO 

DL'TERM(0).(0:1) 

Indicates if the dtvict it * ttmintl. Aluaya a ont. 

- Dtvict it not a ttrninal. 

1 - Dtvict is a ttminal. 

DL'UP(0).(1:D 

Indicates if the dtvict it "up". 

- Dtvice is not up. 

1 - Dtvict is up and has bttn speedstnstd or FOPEN'ed. 

DL'ACTIVE(0).(2:1) 

Indicates the nonitor is active. 

- Tht nonitor it not activt. 1 - Tht nonitor it activt and proettting t 
function. 

DL* REQUEST (0). (3:1) 

Indicatet if tht nonitor was auaktntd uhilt activt. 

- There is no pending request. 

1 - The nonitor uas awakened uhilt activt and has a ptndwg 

rtqutst. 

DL'RESET(0).(4:1) 

Indicattt if tht nonitor should rtinitializt tht port. 

- Don't reinitialize tht port. 

1 - Rtinitializt the port. This it tquivaltnt to doing 

an A80RTJ0B or device close against tht port. 

DL'eR0KEH(O).f5:1) 

Indicates if the port is broken. 

- The port is not oroken. 

1 - The driver detected an error and narked the port 

broken. Tht error code uill be in DL' ERROR' CODE. 

DL'T?UFRVAIt(0).(7:1) 

Indicates if a TBUF is ncu available for the device. 

- No neaning. 

1 - A TBUF(s) is Available and the uritt can rtsunt. 
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Terninal Mo nitor PIT Foraat 



2 3 4 5 6 7 8 9 10 11 12 13 14 15 
-t-T-l — I— -I — I — I — • — • — 1 — ■ — ■ — ■ — 1 — ! 



TE ACT IRE IBROI |TBU| TRUE HRROUARE UNIT NUMBER 
RH IUP HVEIREOISETINENI |FAV| OF PORT (0 - 127) 
... , ... | ... | ... | .- 1 — | — | — | ——--.—. 



SYS OB RELATIVE POINTER TO NEXT DIT UAITING FOR SYSIO 



IOQ TABLE RELATIVE POINTER TO HEAD IOQ 



3 1 LOGICAL DEVICE NUMER 



SYS DB RELATIVE POINTER TO DRIVER LINKAGE TABLE 



5 I SYS OB RELATIVE POINTER TO INTERRUPT LINKAGE TABLE 
, ... | ... | ... | — | — | 1 — | 1 — | 1 — 

HfiN " i CFB * i • !5! IIP! L* , 

6IGUPI IIL I IXONI IAD | ON ACK 

| ...,...,. ..|..-|... | 1 — | 1 — | |~|— 

7 | INTERRUPT MANAGER COMMUNICATION UORD 
....... | ... | ... | 1 — | 1 — | — | — | 1 

10|PRE|PRE|BIN|SPD| UAIT |FLU| LOGON |N0 |CON|PF | PREEMPT 
IEMPISPAIARYISNSI REASON |SH | TYPE |CAT|MOD|REC| LEVEL I 



.| — |- 



-I — I — I — I- 



1l!"TERMlNAL"0SrRELATIVE POINTER TO PROTOCOL 8. DATR MANAGER DIT 

— — — JCONFIGURED UNIT NUMBER (0 - 95) I 
'...| 1~-| 1 1 — | 1 — 

13JP/FI PCC DATE CODE |P/F| MCC DATE CODE |P/F| HSC DATE CODE IJPT 



I— I- 



-I— I- 



14 | DEVICE TYPE SUPPORTED I DUMMY DRIVER 
| BY THIS DRIVER \ VERSION NUMBER 



I— I- 



-I — I— I— 



-I- 



151 RESERVED FOR SYSTEM LOGGING 
I- 



| CONTROL! I NO |BRK 
I TYPE I SSI FIX | MOD 
-I— I — I- " 



161 RESERVED FOR SYSTEM LOGGING 



I- 
17| ERROR CODE 



I — I 
20 | TIM | NEXT READ TIME OUT VALUE - 10THS/SEC 

I— I- 



21 | SAVED IOQ PARRMETER 



22 1 LOGON TIME OUT INDEX 



23 1 TEMP STORAGE FOR MONITOR 



I- 



24 | LAST TIMED REAO VALUE 
| 
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DL'TRUEUNIT(0).(8:8) 



Contains tht trut unit nunbtr of tht dtvict. It only uttd for devices con- 
nected to an ATP/ATP37 controller. Unit nunbtr* uill rangt fron to 127. 



UORO 1 

DL'tfKT 

Containt a SYS DB relative pointer to tht ntxt DIT uaiting for SYSIO/TERMIO. 

UORD 2 

DL'IOQP 

Containt a IOQ tablt rtlativt pointer to tht current IOQ. 

UORO 3 

DL'LDEV 

Containt tht configured logical dtvict nunbtr of tht dtvict. 

UORO 4 

DL'DLTP 

Containt a SYS DB rtlativt pointtr to tht drivtr linkagt tablt. 

UCRD5 
DL'ILTP 
Containt a SYS DB rtlativt pointtr to tht interrupt linkagt tablt. 

UORD 6 

DL'TICK 

Tht TICK connunicatien uord. If a tintr it running and expires tht bit cor- 
responding to tht typt of tintr it set in DL'TICK. Tht nonitor it then 
auakened to process the tint out. 

DL* HANGUP* T0(6). (0:1) 

Tintr uttd by tht Initiation ftanagtr uhtn disconnecting a noden. 
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Ot'CFRIL'TOtfJ.^I) 

Tiner ueed by tht Initiation llanagtr and Inttrrupt flanagtr uhtn trying to 
eonntct a nodtn, uaiting for OSR and 0C0 to cont on or uhtn thtrt it a car- 
ritr fail. 

DL'X0M , T0(6).(4:1) 

Tintr uttd by tht Inttrrupt flanagtr uhtn uaiting for an XGN. 

DL'RER0'T0(6).(8:1) 

Tintr uttd by tht Initiation flanagtr and Inttrrupt lUnagtr for rtadt. 

DL'LDGOrTOCSMIItl) 

Tintr uttd by tht nonitor for a logon tint out. 

DL'RCK'TOW.O^O 

Tintr uttd by tht ROCC phytical drivtr for a 10 ENQ/RCK tintout. 

UORD 7 

DL'XNT'KRN 

Tht Inttrrupt flanagtr connunicetien uord. Uhtn tht Inttrrupt flanagtr nttdt 
to auaktn tht nonitor it uill plact an inttrrupt codt in this uord and thtn 
auaktn tht nonitor via RURKETERMNRL Thit uord eontaint 4 4-bit fitldt to 
that tht Inttrrupt flanagtr nay auaktn tht nonitor for nort that ont rtaton. 
Tht fitldt art procttttd by tht nonitor ltft to right. Inttrrupt codtt art 
at folleut: 

1 - Oitconntct inttrrupt. Data ttt rt*iy hat dropptd or earritr 

fail hat occurred nort that 50 tintt during tht rtad. Tht 
nonitor uill initiatt a ditconntct ttqutnct of tht nodtn. 

2 - Partial harduart tttup. Tht harduart hat bttn partially 

ttt up and tht nonitor uill call tht Initiation flanagtr to 
continut/finith tttting up tht harduart. 

3 - Partial rtad inttrrupt. Tht rtad hat bttn conpltttd or thtrt 

utrt no TBUFt availablt to conplttt tht rtad. Tht nonitor uill 
call tht Initiation flanagtr to conplttt tht rtad. 

4 - Partial uritt inttrrupt. Tht uritt uat a critical uritt 

or thtrt uat an "RCK H tint out or tanking nttdt to bt 
rttuntd en tht uritt. Tht nonitor uill call tht 
Initiation flanagtr to continut/conplttt tht uritt. 

5 - Spttdttntt inttrrupt. Tht dtvict hat tucctttfully bttn 

tpttdttnttd. Tht nonitor uill auaktn "DEVREC" for dtvict 
recognition and thtn call tht Initiation flanagtr to 
initializt tht port. 
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6 - Subtytttn break inttrrupt. R tubtytttn break hat bttn 

dtttcttd. Tht nonitor uill call "BREAMS" to ttt if APE 
uill acctpt tht tubtytttn break. The Initiation flanagtr 
it thtn calltd. If reading tht read data it returntd. 
If unting tht uritt data it fluthtd. Tht fluth bit it 
thtn ttt in all linktd IOQs. If tht tubtytttn break it 
not acctpttd tht current optration it retuntd. 

7 - Optration dent. Tht current uritt it conplttt and tht 

nonitor nttdtd to bt notifitd. 

8 - Break inttrrupt. fl break inttrrupt hat bttn dtttcttd. 

Tht nonitor uill call "BRERKJOB" to ttt if APE uill 
acctpt tht break. If acctpttd tht Initiation flanagtr it 
calltd. If reading tht read data it returntd. If 
uriting all uritt data it fluthtd. The IOQt are thtn 
narfctd broktn. If the break it not acctpttd the current 
operation it retuntd. 

9 - Rtttt dont. Tht rettt of tht port it conplttt. Tht 

nonitor uill tithtr continue uith tht "open" if in tht 
niddlt of tht "optn" or ttart of a tpttdttnte. 



UORD 8 

DL'PREEnPT(8).(0:1) 

Indicattt if thtrt it a pretnptivt requttt. 

- No pretnptivt requttt. 

1 - Stt by RTTRCHIO if thtrt it a pretnptivt IOQ linktd 

in tht DIT. 

DL'PRESPRCE(8).(1:1) 

Indicattt if tht drivtr it pretpacing urittt. 

- Pretpacing it not tnabltd. 

1 - Tht latt IOQ tptcifitd pretpacing. 

DL'8INRRY(8).(2:1) 
Indicattt if in binary node. 

- Not in binary node. 

1 - Binary node. 

DL'SPD*SNS(8).(3:1) 

Indicattt if tht dtvict hat bttn tpttdttnttd. 

- Tht dtvict hat not bttn tpttdttnttd. 

1 - Tht dtvict hat bttn tpttdttnttd. 
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DL'URIT'RSN(8).(4:3) 

Thit indicattt that tht nonitor it uaiting to bt auaktntd by tht Inttrrupt 
flanagtr. Uait reatone are at follout: 

- Not uaiting. 

1 - Oitconntct conplttt. 

2 - Harduart ttt up conplttt. 

3 - Pretnpt conplttt. 

4 - Partial IOQ conplttt. 

5 - IOQ conplttt. 

6 - Hard rettt conplttt. 

7 - Unuttd. 

OI/FLUSHW.^I) 

Indicattt if break uat acctpttd by "BRERKJOB". 

1 • Break uat acctpttd and all IOQt thould bt fluthtd 
until a dtar fluth and uritt requttt it procttttd. 

OL' LOGON' TYP(8). (8:2) 

Indicattt tht logon type. 

- Data accepting dtvict. 

1 • Stttion. 

2 - Job. 

DL'D0NT'CRT(8).(10:1) 
DL'C0NS0LE(8).(11:1) 
Indicattt if in console node. 

- Not in contolt nodt. 

1 - Dtvict it in contolt nodt. 

OUPF'RECVW.WiU 

Indicattt if a power fail occurred and tht drivtr thould go through itt poutr 
fail procttting. 

- No poutr fail occurred. 

1 - R poutr fail hat occurred and tht drivtr uill procttt 

tht poutr fail. 

Dt'PRP'LEVELW.OSrS) 

Containe tht pretnpt level of tht current uritt. 
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UORO) 

Dl'PD'DITP 

Containe a TOS relative pointer to the Protocol and Data flanager DIT. 

UORD 10 

DL'UNIT(10).(8:8) 

Containe the configured logical unit nunber of the device. It ie only uttd 
for devicee connected to the RTP/RTP37 controller. Unit nunbere uill range 
f ron to 95. 

UORO 11 

Ol'DRTE'COOC 

Containe infornation that indicattt the level of hardware. For en RTP con- 
troller thie uill contain the date codee of the 680V e and the reeulte fren 
eelf ttet. For the ROCC thie ie unuttd. 

UORO 12 

0L'DEVTYPE(12).(O:6) 

Indicattt the driver type. For terninale the driver type uill be 16. 

0L'VERSION(12).(6:5) 

Indicattt tht current vtreion of the driver. For RTP the driver ie 
HIOTERfll/HIORSLPO and for the ROCC the driver ie HI0TERH2/HI0RSLP2. 

0L'CONTROLLER(12).(11:2) 

Indicattt tht type of controller ueed by thie LDEV. 

1 - RTP. 

2 • ROCC. 

DL'SST0(12).(13:1) 

Indicattt hou to procttt tht logon tintr that ie running. 

- If the logon tintr expiree the logon did not occur and 

the port thould bt ditconntcttd. 

1 - If tht logon tintr txpiret tht epeedeenee thould bt 

aborted and restarted. 
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DL'UNFIXA8LE(12).(14:1) 

Indicatet if the port it broken end unfixable. 

- Port it not unfixable, but n»y be broktn. 

1 - Port it unfixable. A uarnttart of the tysten uiil retet the port. 

DL'BRK'flODE(12).(15:1) 

Indicatet if the deviee it in breek node. 

- The diviee it not in breek node. Cleared with an IOQ 

function code of 31. 

1 - Tht dtvice it in break node. Set uith an IOQ function 

code of 31. 



WORD 13 

DL'LOG 

Uted for tytten logging. When a port failure occurt LYNX' ERROR uill tavt in 
here the ttatut regitter fron the ttack narker. 

UORD 14 
DL'LOGI 



Uted for tytten logging. Uhen a port failure 
here the P regitter fron the oteck n*rk%r. 



UORO 15 
DL'ERROR'CQOE 



LYNX' ERROR uill tavc in 



Containt the error code uhen a port failure occurt. The code it placed here 
by LYNX'ERROR uhen the failure occurt. It it a 4-digit (dtcinal) code uhere 
tht firtt tuo digitt are the nodule nunber in uhich the error occurred and 
the eecond tuo are a unique error code. 
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UORO 16 

OL'TinE'FLfl&OSMOM) 

Indicatet if the nex* tad uill bt tined. 

- Tht next -M.t is not tined. Cleared uith an IOQ function 

code of y t. 

1 - The next read uill be tined. Set uith an IOQ function 

code of 17. 

0L'RER0'TVflL(16).(1:1S) 

Contains the tine out value for the next read that it to be tined. Set uith 
an IOQ function code of S 

DL'TWE 

R reference tn both -«ad tine fields. 

UORD 17 
DL'QPRRn 
Saved IOQ paraneter. 

UORD 18 

DL'LOON'TRLX 

Containt the logon tinei index. 

UORO 20 

DL'TEBP 

Tenporary atorage uted by nonitor 

UORD 19 

DL'RERD'TIHE 

For reads that trt tined, DL'TME'FLAG » 1, thit uill contain tht read tine 
for the latt read. 



0.23.00 
25- 86 



RTP/RTP37/RDCC 



Line Printer flonitor PIT Fornat 



1 2 3 4 5 5 7 8 9 10 11 12 13 14 15 

|...|...|...|—|— I— I— I— I— I— I— I— I— I— I— I— 
|TE I |RCT| |RE IBROI |TBU| TRUE KRRDURRE UNIT NUflBER 
OjRfl |UP IWEIREQISETIKENI |FRV| OF PORT (0 - 127) ! 

1 SYS OB RELATIVE POINTER TO NEXT DIT WRITING FOR SYSIO 



2 



LOGICAL DEVICE NUflBER 

SYS DB RELATIVE POINTER TO DRIVER LINKAGE TABLE 

5 SYS DB RELATIVE POINTER TO INTERRUPT LINKRGE TABLE 

|_|-.|_|— | 1—| 1— | j— j- 

HflNl ICFAI || IRE I ILQGI I I 
GUPI IIL I |XON| |AD I ION | |ACK| 



11 
121 



15 



IOQ TABLE RELATIVE POINTER TO HEAD IOQ 



-I — I— I— I — I- 



-|-.|. 



INTERRUPT flRNAGER COIWUNICATION UORD 

10IRESI |PRE| KOI | 

SET | |SPR|STP|UAT| 

...| |...|.-.|~l- 



-I— 1~ 



-I — I- 



TERI1INAL DST RELATIVE POINTER TO PROTOCOL 8. DATA nANRGER DIT 
1- 



| CONFIGURED UNIT NUflBER (0 - 95) 

13JP/FI PCC DATE CODE |P/F| ItCC DATE CODE |P/F| flSC DATE COOE IJPT 
..| 1 ...| 1 — | 1— |— |— 

14 DEVICE TYPE SUPPORTED I DURflY DRIVER ICONTROLI I NO | 
BY THIS DRIVER I VERSION NUflBER |TYPE | FIX| 



RESERVEO FOR SYSTEfl LOGGING 



16 RESERVED FOR SYSTEfl LOGGING 



17| ERROR CODE 



201 TEflP STORAGE FOR RONITOR 
, 
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UOROO 

DL'TERfl(0).(0:1) 

Indicatet if the device it a teminal. Always a one. 

- Device it not a teminal. 

1 • Device it a teminal. 

DL'UP(0).(1:1) 

Indicattt if the device is "up". 

- Device is not up. 

1 • Device it up and hat been FOPEN'ed. 

0L'RCTIVE(O).(2:1) 

Indicatet the monitor is active. 

- The nonitor is not activ?. 

1 - The nonitor it active and processing a function. 

DL'REQUESWJ.OtD 

Indicatet if the nonitor uas auakened uhiie active. 

- There is no pending request. 

1 - The nonitor uas awakened uhile active and has a pending request. 

DL'RESET(0).(4:1) 

Indicatet if the monitor should reinitialize the port. 

- Don't reinma'.-ze the pert. 

1 • Reinitialize t!-» port. This is equivalent to doing 

an ABORTJOB or device close against the port. 

DL'BR0KEN(O).(5:1) 

Indicates if the port is broken. 

- The port is not broken. 

1 - The driver detected an error and narked the port 

broken. The errcr codk uill be in OL'ERROR'COOE. 

DL'TBUFRVRILfOM?:!) 

Indicates if a TBUF is now available for the device. 



G. 23.00 
25- 68 



RTP/RTP37/R0CC 



DL'TRUEUNIT(0).(8:8) 

Contains the true unit nunber of tht device. It only used for devices con- 
nected to an ATP controller. Unit nunbers uill range fron to 127. 



UORD 1 
Of NEXT 

UORO 2 
OL'IOOP 
Contains an IOQ tabic relative pointer to the current IOQ. 

UORO 3 
OL'LOEV 
Contains the configured logical device nunber of the device. 

UORO 4 

OL'OLTP 

Contains a SYS 06 relative pointer to the driver linkage table. 

UORO 5 
DL'ILTP 
Contains a SYS OB relative pointer to the interrupt linkage table. 

UORO 6 

Of TICK 

The TICK coimunication word. If a tincr is running and expires the bit cor- 
responding to the type of tirter is set in 01' TICK. The nonitor is then 
attakened to process the tineout. 

DL' HANGUP' T0(6). (0:1) 

Tincr used by the Initiation llanager uhen disconnecting a noden. 
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UORO 8 

DL'RESETTING(8).(0:1) 

Set if the port should be reset. 

DL'PRESPRCE(8).(4:1) 

Set if the last request used prespacing. 

OL'NO'STP'OVtSMSil) 

Set if the driver docs not pcrforn auto perforation skip. 

0L'UMT(8).(6:1) 

Set if the nonitor is uaiting for a request to conplctc. 

DL'PF'REC(8).(12:1) 

Set if the nonitor should execute its power fail recovery code. 

UORO 9 

OL'PD'DITP 

Contains a TOS relative pointer to the Protocol and Oata llanager OIT. 

LDRD 10 

0L'UNIT(*0).(8:8) 

Contains the configured logical unit nunber of the device. It it only used 
for dmcts connected to the RTP controller. Unit nunbert uill range fron 
to »5. 

uor: ii 

OLTWCODE 

Contains information that indicates the level of hardware. For an RTP con- 
troller this «:11 contain the data codes of the 6801 'a and the results fron 
self test. For the ROCC this is unused. 

UORO 12 

0l ! DEVTYPE(12).(C:6) 

locates the drivei type. For printers the driver type uill be 32. 
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0L'CFRIL'T0(6).(2:1) 

Tiner used by the Initiation llanager and Interrupt flanager uhen trying to 
connect a noden, uaiting for OSR and 0C0 to cone on or uhen there is a car- 
rier fail. 

DL'X0N'T0(6).(4:1) 

Tiner used by the Interrupt llanager uhen uaiting for an XOM. 

0L'RER0'T0(6).(8:1) 

Tiner used by the Initiation flanager and Interrupt flanager for reads. 

DL'L0G0N'T0(6).(11:1) 

Tiner used by the nonitor for a logon tineout. 

DL'RCK'T0(6).(14:1) 

Tiner used by the ROCC physical driver for a 10 ENQ/RCK tineout. 



DL'INT'IIRN 

The Interrupt flanager connunication uord. Uhen the Interrupt flanager needs 
to auaken the nonitor it uill place an interrupt code in this uord and then 
cuaken the nonitor via RURKETERfllNRL. This uord contains 4 4-bit fields so 
that the Interrupt flanager nay auaken the nonitor for nore than one reason. 
The fields arc processed by the nonitor left to right. Interrupt codes tn 
as follows: 

1 - Disconnect interrupt. Data set ready has dropped or carrier 

fail has occurred nore that 50 tines during the read. The 
nonitor uill initiate a disconnect sequence of the noden. 

2 - Partial harduarc setup. The harduare has been partially set 

up and the nonitor uill call the Initiation flanager to 
continue/finish setting up the harduare. 

4 - Partial uritc interrupt. The urite uas a critical urite 
or there uas an "RCK" tine out or tanking needs to be 
resuned on the uritc. The nonitor uill call the 
Initiation flanager to continue/conpletc the urite. 

9 - Reset done. The reset of the port is conpletc. The 
nonitor uill cither continue uith the "open" if in the 
niddlc of the "open" or start a speedsense. 
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Dl'VERSIQM(12).(6:5) 

Indicates the current version of the driver. For RTP the driver it HI0TERI11 
and for ROCC the driver is HI0TERM2. 

0L'C0NTR0Ll£R(12).(11:2) 

Indicates the type of controller used by thit LDEV. 

1 - RTP. 

2 - ROCC. 

0L'UKFIXR6l£(12).(14:1) 

Indieatet if the port it broken and unf ixable. 

- Port is not unfixable, but nay be broken. 

1 - Port is unfixable. R uantstart of the systcn uill reset the port. 

UORO 13 

DL'LOG 

Used for tystcn logging. Uhen a port failure occurs LYNX' ERROR uill aave in 
here the status register fron the stack narker. 

UORO 14 

OL'LCSI 

Used for systcn logging. Uhen a port failure occur* LYNX' ERROR uill save in 
here the P register fron the stack narker. 

UORO 15 

OL' ERROR' CODE 

Contains the error code uhen a port failure occurs. The code is placed here 
by LYNX'ERROR uhen the failure occurs. It is a 4-digit (decimal) code uhere 
the first tuo digits are the nodule nunber in uhich the error occy-red and 
the second tuo *rt a unique error code. 



UORO 16 
OL'TEflP 
Tcnporary storage used by nonitor. 



U^ 
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ILT/ILTX Fornat 



RTP/RTP37 ILT Fornat 



1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 
| — | — | — I — I — I — I — I — I — I — I — ■ — I — I — I — I — I 

Ol 

1 1 CHANNEL PROGRRfl VARIABLE AREA - CPVR 

21 (NOT USED - SET TO 0) 

31 



4| OHR RBORT RDORESS 
51 (NOT USED - SET TO 0) 

61 (NOT USEO - SET TO 0) 



, ... , 1 

7| (1 | CHRNNEL QUEUE ■ I IP 
| ... , 1 

101 CHRNNEL PROCRRH POINTER - ILTX 



-I 

I CHANNEL 



-I- 



-I 

i DEVICE 



I- 



11| STATUS RETURN RRER POINTER - (NOT USEO - SET TO 0) 



121 UNIT EXTRACT INSTRUCTION - (NOT USED - SET TO 0) 



131 CURRENT DIT POINTER - (NOT USED - SET TO 0) 
14| SIOP SIZE I CQUEN 

15IC0NTR0LLER FLAGS - (SET TO 0) j HIGHEST UNIT « 



I- 



-I- 



161 SYSDB RELATIVE DIT POINTER FOR UNIT ON SIB 



I SYSDB RELATIVE DIT POINTER FOR UNIT N ON SIB 
| 



UORD Z7 

ILrDAT.(7:9) 

Contains DAT nuitber for controller en channel. 

UORD Z10 

ILT'ISIOP 

Contains a SYSDB relative pointer to the channel progrtn area also known 
the ILTX. 
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ADCC ILT Fornat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
_l_l_l-.|_l— I— I— 1—|— l-H—l— 1— I— I— I 
CHANNEL PROGRAfl VRRIRBLE AREA - CPVA 



I- 



DflR RBORT RDORESS 
(NOT USED - SET TO 0) 



61 (NOT USED - SET TO 0) ^ ^^ 

7| ii | CHANNEL QUEUE • I IP I CHANNEL I DEVICE 
CHANNEL PROGRAfl POINTER - ILTX 



101 

I 



111 STATUS RETURN RRER POINTER - (NOT USED - SET TO 0) 

I 



121 UNIT EXTRRCT INSTRUCTION - (MOT USEO - SET TO 0) 
I- 



131 CURRENT DIT POINTER - (NOT USEO - SET TO 0) 



I- 



141 SIOP SIZE 



-I- 



| CQUEN 
•I— I 

CONTROLLER FLAGS - (SET TO 0) I HIGHEST UNIT M 



I 
151 

| 

161 SYSDB RELATIVE DIT POINTER 



-I- 



I- 
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UORD Z14 

ILT'SIOP'SIZE.tOrS) 

Contains size, in uords, of channel progran tn* (ILTX). 

UORD Z15 

ILT , KUNIT.(9:7) 

Contains the highest configured unit nuneer on the channel. 

UORD Z16 

Starting at uord Z16 there is a SYSDB relative pointer to the nonitor DIT for 
each unit configured on the channel. 

RTP/RTP37 ILTX Fc^nat 



0| TERHINRL DATA SEGflENT DST NUI1BER FOR 1ST DST 
1| TERHINRL DATA SEGflENT BANK NUHBER FOR 1ST DST 



21 TERHINRL DATA SEGflENT DST OFFSET FOR 1ST DST 
, .-| 

3 1 ID | (NOT USEO - SET TO 0) 
| ... | 

4 | CONTROLLER ID 
, 

5 | INTERRUPT PROCESSOR P LABEL 

I- 



6 | TERHINRL DRTR SEGflENT DST NUflBER FOR 2ND DST 
I- 



7 | TERHINRL DRTR SEGflENT BRNK NUflBER FOR 2ND DST 
I- 



101 TERniNRL DATA SEGflENT DST OFFSET FOR 2ND DST 
11 1 ID I (NOT USED - SET TOO) 



121 CONTROLLER ID 



I- 



131 INTERRUPT PROCESSOR PLRBEL 



I- 



G. 23.00 
25- 94 



RTP/RTP37/RDCC 
RDCC ILTX Fomat 

, 

01 TERMINAL DRTR SEGflENT DST HUnBER 

I 

1 | TERHINRL DRTR SEGflENT BRNK NUflBER 

| 

21 TERHINRL DRTR SEGflENT DST OFFSET 

I — I 

3 1 ID I (NOT USED - SET TO 0) 

| ... | 

4| CONTROLLER ID 
| 

51 INTERRUPT PROCESSOR PLRBEL 
| 

6] 

3151 RDCC CHRNNEL PROGRRfl 
I 
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